AiVideoEditor
Inizia gratis
Menù

Revisionato 2026-11-11 · Versione API 2026-11-09 · Leggi Markdown

Pubblicazione e programmazione

Un post AiVideoEditor ha una bozza versionata e consegne indipendenti per gli account selezionati. Il salvataggio delle bozze è permissivo; un salvataggio riuscito non stabilisce che ogni destinazione sia pubblicabile.

Preparare un post

  1. Leggi /api/v1/accounts e /api/v1/capabilities con la chiave prevista.
  2. Carica e finalizza gli eventuali media richiesti.
  3. Crea una bozza con POST /api/v1/posts, o modifica con PATCH /api/v1/posts/{id}. Fornisci l'attuale expectedVersion sulle modifiche e conserva la versione restituita.
  4. Imposta il formato della destinazione ed eventuali override espliciti di variante per account dove necessario. Il riferimento API definisce i campi della richiesta.
  5. Valida con POST /api/v1/posts/{id}/validate. HTTP 200 può contenere valid: false; esamina ogni problema prima di inviare. Gli account non validi non vengono rimossi silenziosamente dall'audience.

Pubblicare ora o dopo

POST /posts/{id}/publish invia la bozza corrente. POST /posts/{id}/schedule richiede scheduledAt, timezone e expectedVersion. L'istante programmato deve essere futuro e entro 90 giorni. Memorizza un timestamp UTC ISO e un separato fuso orario di visualizzazione IANA; risolvi le ambiguità dell'ora legale prima di inviare.

Usa una Idempotency-Key distinta per ogni nuova mutazione. Conserva quella chiave e l'esatto corpo della richiesta prima di inviare. Dopo un timeout, ripeti la richiesta identica con la stessa chiave. Cambia la chiave solo quando richiedi intenzionalmente una nuova operazione. Una modifica o programmazione di bozza non aggiornata restituisce revision_conflict; rileggi e esamina l'ultimo contenuto invece di sovrascriverlo alla cieca.

Una risposta 202 significa accettata per l'invio. Non è prova di pubblicazione. Registra gli ID di consegna e osserva GET /posts/{id} o i webhook firmati del cliente. Usa polling limitato con ritardi crescenti; fermati per risultati terminali o un handoff umano invece di ciclare all'infinito.

Esiti per destinazione

Le consegne possono concludersi indipendentemente. Una destinazione può pubblicare mentre un'altra richiede riconnessione o consenso. Mostra ogni stato e il link nativo del post quando presente. Riprova solo un fallimento noto idoneo usando POST /deliveries/{id}/retry. Le destinazioni riuscite non devono essere ricreate per recuperare una fallita. Un esito esterno sconosciuto richiede riconciliazione o revisione, non un nuovo invio.

Annulla con POST /deliveries/{id}/cancel finché il lavoro resta sicuramente non preso in carico. too_late_to_cancel significa che l'invio è progredito oltre la cancellazione sicura; non significa che il post esterno sia stato rimosso.

Revisione umana TikTok

Leggi /accounts/{id}/tiktok/settings per le impostazioni correnti del creator e le scelte di privacy disponibili. Una lettura delle impostazioni o un salvataggio di bozza non fornisce il consenso. consent_required include un handoff sicuro requiresAction verso il composer autenticato. Una persona autorizzata esamina lì l'esatto video, testo del post e destinazione e conferma esplicitamente le scelte richieste. Le product key e gli strumenti MCP non possono confermare al suo posto. Modifiche al contenuto o all'identità richiedono una nuova revisione. L'handoff da solo non concede membership o accesso.

Controlli del composer

Usa Aggiungi media per caricare un file o scegliere un elemento esistente dalla libreria. Il testo del post è condiviso finché Personalizza contenuto non crea una variante specifica per account. Gli strumenti per emoji e hashtag inseriscono testo normale alla posizione del cursore.

Opzioni di pubblicazione raggruppa le impostazioni per l'account selezionato. Le scelte obbligatorie restano visibili; i gruppi opzionali restano chiusi. Le modifiche si applicano solo a quell'account. Anteprima mostra la bozza effettiva senza salvarla o inviarla, incluse le bozze incomplete; la presentazione nativa della piattaforma può differire.

Usa riferimenti ad asset privati per copertine e thumbnail programmati. Le alternative con URL pubblico devono restare raggiungibili al momento della consegna. Il contenuto dei sottotitoli è memorizzato con le impostazioni immutabili invece di dipendere da un file locale temporaneo. L'upload di documenti LinkedIn attualmente accetta PDF; i formati Office restano limitati finché la validazione della firma non è implementata.

Vedi il riferimento alle capability per i controlli canonici e i limiti di integrazione. Il nuovo comportamento di formato e conferma richiede le corrispondenti migrazioni del database prima del deployment.