Ottieni un processo di pubblicazione in blocco

Fornisce informazioni su un processo creato da POST /social/bulk-posts. Interrogalo periodicamente finché status non raggiunge un valore finale, quindi leggi results[] per conoscere l'esito di ogni riga.

Caso d'uso: riconciliare un caricamento in blocco con il tuo calendario. Dopo aver inviato un batch, interroga questo endpoint ogni pochi secondi. Quando status è in uno stato finale, scorri results[] e associa clientReference di ogni voce al tuo record, scrivendovi socialPostId. Le righe con status: "FAILED" riportano il motivo in errors[]; invia nuovamente solo quelle in un nuovo batch.

Caso d'uso: una barra di avanzamento. Il rapporto tra processedCount e totalCount basta per alimentarla senza scorrere affatto results[], mentre successCount / failureCount ti forniscono il riepilogo non appena il processo termina.

Stati del processo

Note.

• clientReference è il valore che hai inviato per quella riga, restituito senza modifiche. È il collegamento più diretto ai tuoi dati; index, la posizione della riga nell'array che hai inviato, con indice a partire da 0, è l'alternativa quando non hai inviato alcun valore.
• Una riga che raggiunge status: "CREATED" indica che il post esiste, non che sia stato pubblicato — postStatus indica a che punto si trova il post stesso. Le righe PUBLISH e SCHEDULE passano comunque in seguito attraverso la pipeline di pubblicazione asincrona: usa ogni socialPostId con GET /social/posts/{postId} e leggi channels[] per conoscere l'esito effettivo per ciascun canale.
• Un processo in cui nessuna riga ha superato la validazione non sarebbe mai stato creato, perché la creazione in blocco rifiuta il batch prima di metterlo in coda. Un processo FAILED qui indica che il processo ha subito un errore dopo essere stato accettato.
• updatedAt cambia man mano che le righe vengono elaborate; si stabilizza quando il processo raggiunge uno stato finale.