Synup
Créer une clé
v1Ressources/Posts/postRécupérer les destinations en échec d'une publication

Récupérer les destinations en échec d'une publication

Crée une nouvelle publication en brouillon pour les destinations où une publication n'a pas pu être publiée, afin que vous puissiez la corriger et l'envoyer à nouveau. Utilisez-la pour une publication au statut partial (certaines destinations sont en ligne, d'autres ont échoué) ou error (aucune n'est en ligne). Le brouillon reprend le contenu et les médias de l'original et cible uniquement les connexions en échec. Rien n'est publié ni planifié : modifiez le brouillon si le réseau a refusé le contenu, puis planifiez-le ou publiez-le comme toute autre publication. Le brouillon ne peut cibler que ces destinations en échec : l'ajout d'une autre connexion est refusé avec 409. Les destinations en ligne de la publication d'origine ne sont jamais modifiées. Les destinations en échec passent dans le brouillon et ne peuvent plus être relancées depuis l'original, si bien qu'une publication partial s'affiche ensuite comme active. Un nouvel appel pour la même publication renvoie le même brouillon avec 201 au lieu d'en créer un second. Si ce brouillon a été supprimé, l'appel renvoie 409 et aucune nouvelle récupération n'est créée. Une destination reste sur l'original lorsque son résultat est incertain (le réseau a peut-être déjà la publication), lorsqu'une nouvelle tentative est déjà prévue ou lorsque sa plateforme n'est pas proposée actuellement. Si aucune destination ne remplit les conditions, l'appel renvoie 422. Les publications de série, celles qui font partie d'une publication multi-clients et les publications importées ne peuvent pas être récupérées ici. L'utilisateur de la clé API doit être actif et avoir accès à Social et au client de la publication. Si la récupération n'est pas disponible pour votre espace de travail, l'appel renvoie 404. N'envoyez pas de corps de requête.

post/api/v1/posts/{id}/recover-failed
posts:write
Paramètres de requête
idstringobligatoire
La publication dont l'envoi a échoué, par id ou identifiant public.
Réponse
dataobjectfacultatif
idstringfacultatif
L'id du brouillon de récupération. Utilisez-le pour modifier, planifier ou publier le brouillon.
publicIdstringfacultatif
L'identifiant public du brouillon de récupération, ou null s'il n'en a pas.
statusstringfacultatif
Le statut du brouillon de récupération : draft pour une nouvelle récupération. Un nouvel appel renvoie le statut actuel du brouillon existant, par exemple scheduled une fois qu'il a été planifié.
connectionIdsarray of stringfacultatif
Les connexions sur lesquelles le brouillon sera publié : les destinations en échec de la publication d'origine.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409La publication a changé pendant la création du brouillon, une récupération existe déjà pour cette publication ou a été supprimée, ou la publication fait partie d'une publication multi-clients. Actualisez la publication et réessayez.
422La publication ne peut pas être récupérée : son statut n'est ni partial ni error, elle appartient à une série, aucune destination en échec ne remplit les conditions, ou la connexion d'une destination en échec est déconnectée ou n'est pas proposée.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
500Le brouillon de récupération n'a pas pu être créé. Actualisez la publication et réessayez.
503L'opération sur la publication n'a pas pu être effectuée.
post/api/v1/posts/{id}/recover-failed
Votre clé API
id *
{}

Guides qui utilisent cette ressource