Créer des publications en masse

Crée plusieurs publications sur les réseaux sociaux en une seule requête. Les lignes sont transmises dans le corps de la requête — aucun téléversement de fichier ni CSV, simplement un tableau contenant les mêmes objets que POST /social/posts accepte un par un. Jusqu'à 500 lignes par requête.

Cas d'utilisation : charger un trimestre de contenu en un seul appel. Votre outil de planification contient l'intégralité du calendrier de contenu du client. Créez une ligne par créneau, associez à chacune votre propre clientReference, puis envoyez-les ensemble. Le lot réussit dans son ensemble ou vous indique précisément les lignes à corriger. Enregistrez le job.id renvoyé et interrogez périodiquement GET /social/bulk-posts/{bulkJobId} jusqu'à ce que status atteigne un état final, puis rapprochez chaque résultat de vos données à l'aide de son clientReference.

L'ensemble du lot est validé au préalable

La validation porte sur chaque ligne avant toute création, et le lot est atomique à ce stade :

• Si une seule ligne est invalide, rien n'est créé. success vaut false, SY95050 est renvoyé dans error, et chaque ligne incorrecte apparaît dans job.results[] avec son index indexé à partir de 0, son clientReference et la raison dans errors[]. Corrigez ces lignes et renvoyez l'ensemble du lot.
• Si toutes les lignes sont valides, une tâche est mise en file d'attente, success vaut true et vous obtenez un job.id. Certaines lignes peuvent encore échouer plus tard, lorsque la plateforme les rejette au moment de la publication ; cet échec apparaît dans la tâche, pas ici.

Rapprochez les résultats de vos données à l'aide de clientReference lorsque c'est possible, et de index sinon — les lignes elles-mêmes ne sont pas renvoyées, ces deux champs sont donc le seul lien avec vos propres données.

Remarques.

• Le corps de la requête doit être encapsulé dans un objet input, avec les lignes dans input.posts.
• Vérifiez success, pas le statut HTTP. Un rejet de l'ensemble du lot est un HTTP 200 avec success: false et SY95050 dans error.
• Maximum 500 lignes par requête. Un tableau plus grand est rejeté d'emblée avec SY95048 et rien n'est créé ; divisez-le et envoyez plusieurs lots.
• La marque de chaque ligne est socialProfileId. brandId est exclusivement un paramètre de chemin d'URL, et cette route ne comporte aucun paramètre de chemin.
• Les lignes peuvent cibler différentes marques. Les platforms de chaque ligne sont vérifiés par rapport à la marque de cette même ligne ; une plateforme connectée à une marque mais pas à une autre ne fait donc échouer que les lignes qui en ont besoin.
• Chaque ligne suit les mêmes règles de planification qu'une publication individuelle : scheduledAt ou scheduleDate + scheduleTime, jamais les deux, et scheduleDate / scheduleTime sont interprétés dans le fuseau horaire de la marque de cette ligne. Vous pouvez utiliser les deux formes sur des lignes différentes d'un même lot.
• Les limites de débit s'appliquent à la requête, pas aux lignes : un lot de 500 lignes consomme une requête sur votre quota. Consultez Limites de débit.

Opération d'écriture : non exécutée sur le compte réel. La requête et la réponse présentées sont construites à partir du schéma de l'API ; l'exécution de cette requête publie sur de véritables comptes de réseaux sociaux.