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
- Leggi
/api/v1/accountse/api/v1/capabilitiescon la chiave prevista. - Carica e finalizza gli eventuali media richiesti.
- Crea una bozza con
POST /api/v1/posts, o modifica conPATCH /api/v1/posts/{id}. Fornisci l'attualeexpectedVersionsulle modifiche e conserva la versione restituita. - Imposta il formato della destinazione ed eventuali override espliciti di variante per account dove necessario. Il riferimento API definisce i campi della richiesta.
- Valida con
POST /api/v1/posts/{id}/validate. HTTP 200 può contenerevalid: 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.