Skip to main content
POST
Pubblica o programma i contenuti multimediali originali del progetto sui tuoi canali YouTube/TikTok connessi, facoltativamente con sottotitoli dinamici. L’operazione pubblica su piattaforme esterne; scegli esplicitamente la privacy quando desideri l’accesso pubblico.

Autenticazione e autorizzazioni

string
obbligatorio
Invia una chiave API VoiceCheap in questa intestazione. È supportato anche Authorization: Bearer con la stessa chiave API. I token di accesso OAuth sono accettati solo da MCP, non da questo endpoint REST.
Autorizzazioni richieste: publishing:write, projects:read. È necessario un abbonamento a pagamento attivo. Le autorizzazioni non modificano i ruoli del team, la proprietà delle risorse, i crediti multimediali o i limiti del piano.

Parametri

string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 200. Pattern: ^[^/\\]+$.
string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 200. Pattern: ^[^/\\]+$.
string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 100.
string
Valore testuale.Lunghezza massima: 5000.
array
Elenco di valori. Consulta lo schema di input completo per la struttura degli elementi.Numero massimo di elementi: 20.
array
Elenco di valori. Consulta lo schema di input completo per la struttura degli elementi.Numero massimo di elementi: 20.
string
Valore testuale.Valori consentiti: “public”, “unlisted”, “private”. Valore predefinito: “private”.
string
Valore testuale.Valori consentiti: “PUBLIC_TO_EVERYONE”, “MUTUAL_FOLLOW_FRIENDS”, “FOLLOWER_OF_CREATOR”, “SELF_ONLY”. Valore predefinito: “SELF_ONLY”.
boolean
Valore booleano.Valore predefinito: false.
string
Valore testuale.Formato: “date-time”. Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$.
string
Facoltativo al livello di trasporto: se omesso, il server inserisce un identificatore prima della validazione. Fornisci un tuo UUID v4 stabile per recuperare in sicurezza una risposta persa.Formato: “uuid”. Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$.
Il JSON Schema seguente conserva i nomi esatti dei campi, i tipi annidati, i valori predefiniti, i limiti e i valori accettati esposti dalla discovery. Le ulteriori regole tra campi sono elencate nelle note sull’operazione.

Idempotenza

Usa un UUID v4 in requestId o nell’intestazione HTTP Idempotency-Key per ogni modifica. Riutilizza lo stesso identificatore e argomenti identici dopo un errore di rete. Se vengono forniti entrambi, devono coincidere. Ripetere una richiesta salvata non ripete l’operazione e non consuma un’altra chiamata mensile. Le richieste non riuscite o interrotte non vengono riavviate automaticamente. Ogni modifica può restituire HTTP 202 quando un nuovo tentativo trova la stessa richiesta ancora in esecuzione, anche se la prima esecuzione è normalmente sincrona. Se l’esecuzione è completata ma resultStored è false, un nuovo tentativo restituisce HTTP 200 con lo stato della richiesta salvata anziché il risultato originale. Recupera l’output tramite l’azione di cronologia, risultato o download del relativo dominio.

Esempi di richiesta

Sostituisci gli identificatori delle risorse e le chiavi multimediali di esempio con i valori restituiti per il tuo account. Mantieni stabile l’identificatore della richiesta quando ripeti la stessa modifica.

Risposta

Questa operazione restituisce HTTP 202 mentre è in esecuzione. Salva requestId e interroga action_request_get con questo identificatore e il nome dell’operazione originale. Gli stati del polling sono running, completed, failed e interrupted. Un risultato completato può rimandare a un processo multimediale separato; prosegui con l’azione di stato o di output specifica dell’operazione. Restituisce lo stato pubblico aggiornato della pubblicazione originale dopo aver richiesto la pubblicazione o la programmazione sui canali selezionati.

Campi del risultato

Recupera e monitora questa richiesta

Usa lo stesso identificatore anche dopo una connessione persa. Se resultStored è false, recupera l’output tramite la corrispondente azione di cronologia, risultato o download. Non avviare mai una seconda generazione solo per verificarne l’avanzamento.
HTTP 200

Note sull’operazione

  • Questa azione pubblica all’esterno e richiede la proprietà del progetto. Almeno uno degli array youtubeChannelIds o tiktokChannelIds deve contenere un canale collegato all’attore autenticato; ogni array consente al massimo 20 voci.
  • workId deve appartenere a questo progetto anche se il contenuto multimediale selezionato è il video originale.
  • L’integrazione usa per impostazione predefinita youtubePrivacyStatus private e tiktokPrivacyLevel SELF_ONLY. Imposta esplicitamente la privacy desiderata quando intendi consentire un accesso più ampio.
  • includeDynamicSubtitles è false per impostazione predefinita e richiede subtitles:write quando abilitato. Usa le normali quote dei sottotitoli e i crediti multimediali.
  • scheduledAt è una data e ora ISO facoltativa con offset. Solo un orario strettamente futuro programma il flusso di lavoro dell’originale; un timestamp passato valido non lo programma e può provocare la pubblicazione immediata.
  • Questa è un’azione di lunga durata. Interroga periodicamente action_request_get per il completamento del gestore, quindi publishing_list per l’avanzamento della pubblicazione della risorsa o i risultati programmati.
  • originalPublish può essere null quando non è disponibile alcuno stato, oppure mostrare lo stato in-progress, scheduled, completed o failed. Gli esiti dei singoli canali si trovano in channels, quindi un risultato restituito non garantisce la pubblicazione riuscita su ogni canale.

Utilizzo

Ogni invocazione riuscita consuma una chiamata API/MCP mensile. Si applicano anche i crediti multimediali e le quote di generazione proprie dell’operazione.

Errori