Crea post in blocco

Crea molti post social in un'unica richiesta. Le righe vengono trasmesse nel payload della richiesta — non vengono caricati file e non viene usato alcun CSV, ma solo un array degli stessi oggetti che POST /social/posts accetta uno alla volta. Fino a 500 righe per richiesta.

Caso d'uso: caricare un trimestre di contenuti in un'unica chiamata. Il tuo strumento di pianificazione contiene l'intero calendario dei contenuti del cliente. Crea una riga per ogni slot, contrassegna ciascuna con un tuo clientReference e inviale insieme. Il batch riesce nel suo insieme oppure ti indica esattamente quali righe correggere. Memorizza il valore job.id restituito e interroga periodicamente GET /social/bulk-posts/{bulkJobId} finché status non raggiunge uno stato terminale, quindi riconcilia ogni risultato tramite il relativo clientReference.

L'intero batch viene convalidato prima di procedere

La convalida viene eseguita su ogni riga prima che venga creato qualsiasi elemento, e in questa fase il batch è atomico:

• Se anche una sola riga non è valida, non viene creato nulla. success è false, SY95050 viene restituito in error e ogni riga non valida compare in job.results[] con il relativo index con indicizzazione a partire da 0, il relativo clientReference e il motivo in errors[]. Correggi quelle righe e invia nuovamente l'intero batch.
• Se ogni riga è valida, viene messo in coda un job, success è true e ricevi un job.id. Le singole righe possono comunque fallire in seguito, quando la piattaforma le rifiuta al momento della pubblicazione; questo viene riportato nel job, non qui.

Riconcilia tramite clientReference quando possibile e tramite index negli altri casi — le righe stesse non vengono restituite, quindi questi due campi sono l'unico collegamento ai tuoi dati.

Note.

• Il corpo della richiesta deve essere racchiuso in un oggetto input, con le righe in input.posts.
• Controlla success, non lo stato HTTP. Un rifiuto dell'intero batch viene restituito come HTTP 200 con success: false e SY95050 in error.
• Massimo 500 righe per richiesta. Un array più grande viene rifiutato immediatamente con SY95048 e non viene creato nulla; suddividilo e invia più batch.
• Il brand di ogni riga è socialProfileId. brandId è sempre e soltanto un token del percorso URL, e questa rotta non contiene alcun token di percorso.
• Le righe possono essere destinate a brand diversi. I valori di platforms di ogni riga vengono verificati rispetto al brand della riga stessa, quindi una piattaforma collegata a un brand ma non a un altro fa fallire solo le righe che la richiedono.
• Ogni riga segue le stesse regole di pianificazione di un singolo post: scheduledAt oppure scheduleDate + scheduleTime, mai entrambi, e scheduleDate / scheduleTime vengono interpretati nel fuso orario del brand di quella riga. È consentito usare entrambe le forme su righe diverse dello stesso batch.
• I limiti di frequenza si applicano alla richiesta, non alle righe: un batch di 500 righe consuma una sola richiesta della tua quota. Consulta Limiti di frequenza.

Operazione di scrittura: non eseguita sull'account reale. La richiesta e la risposta mostrate sono costruite a partire dallo schema dell'API; quando viene eseguita, questa operazione pubblica su account social reali.