Synupv1
Créer une clé
v1Ressources/Idées de post/postPublier une idée de post

Publier une idée de post

Publie une idée de post sous forme de véritable post, en le soumettant à ses plateformes cibles. Sauf si scheduledFor ou draft est défini, cela met du contenu réel en ligne immédiatement. id accepte soit le propre id de l'idée, soit l'id externe avec lequel elle a été créée.

post/api/v1/post-ideas/{id}/publish
posts:write
Paramètres de requête
idstringobligatoire
L'idée de post à publier — son id ou son externalId.
Corps de la requête
scheduledForstringfacultatif
Publier à ce futur horodatage ISO 8601 au lieu d'immédiatement.
draftbooleanfacultatif
Enregistrer comme post en brouillon au lieu de publier immédiatement.
Réponse
dataobjectfacultatif
Une plateforme demandée sans connexion active, ou un champ dont l'idée a besoin avant de pouvoir être mise en ligne, ne fait jamais échouer cet appel — l'idée est plutôt enregistrée comme post en brouillon. Rappeler cette route pour une idée qui a déjà un post renvoie alreadyPublished: true au lieu d'en créer un second.
postIdstringfacultatif
ID du post publié à partir de cette idée, ou null si la publication n'a pas abouti.
statusstringfacultatif
Statut de l'idée : draft, published ou archived.
ideaIdstringfacultatif
ID de l'idée de post qui a été publiée.
alreadyPublishedbooleanfacultatif
Si cette idée avait déjà un post issu d'un appel précédent — quand true, rien de nouveau n'a été publié.
missingFieldsarray of stringfacultatif
Champs encore nécessaires avant que le post résultant puisse être mis en ligne, le cas échéant.
missingPlatformsarray of stringfacultatif
Plateformes demandées sans connexion active, le cas échéant.
scopestring (location | client)facultatif
Si l'écart de connexion/champ s'applique au niveau de l'établissement ou du client.
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.
422Il manque un paramètre requis à la requête, ou elle est invalide.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/post-ideas/{id}/publish
Votre clé API
id *
Corps de la requête
{
  "data": {
    "postId": "cm_post_xyz789",
    "status": "scheduled",
    "ideaId": "cm_idea_abc123"
  }
}