Synup
Créer une clé
v1Ressources/Distribution/getObtenir l'état d'une campagne

Obtenir l'état d'une campagne

Renvoie, pour chaque publication de destination, son état, ses approbations, sa planification avec fuseau horaire, ses URL en ligne et sa dernière erreur, ainsi que l'état de chaque fichier.

get/api/v1/distribution/campaigns/{id}
distribution:read
Paramètres de requête
idstringobligatoire
Le campaignId renvoyé par l'importation.
Réponse
dataobjectfacultatif
campaignobjectfacultatif
variantsarray of objectfacultatif
keystringfacultatif
platformstringfacultatif
formatstringfacultatif
statestring (blocked | needs_review | changes_requested | ready | scheduled | paused | publishing | handoff | live | partial | failed)facultatif
blockersarray of stringfacultatif
approvalobjectfacultatif
suggestedForstringfacultatif
scheduledForstringfacultatif
timezonestringfacultatif
liveUrlsarray of objectfacultatif
lastErrorstringfacultatif
assetsarray of objectfacultatif
Erreurs
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.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/distribution/campaigns/{id}
Votre clé API
id *
{
  "data": {
    "campaign": {
      "id": "dcm_123",
      "clientId": "cli_123",
      "clientName": "Acme Dental",
      "externalId": "topic-local-seo-2026-10",
      "title": "Why local SEO still wins",
      "template": "topic",
      "subject": null,
      "currentVersion": 1,
      "paused": false,
      "archivedAt": null,
      "createdAt": "2026-10-01T10:00:00.000Z"
    },
    "variants": [
      {
        "key": "short-1-linkedin",
        "platform": "linkedin",
        "format": "video",
        "state": "scheduled",
        "blockers": [],
        "approval": {
          "editorial": "approved",
          "customer": "not_required",
          "publish": "approved",
          "revision": 1,
          "customerRequired": false
        },
        "suggestedFor": "2026-10-06T13:00:00.000Z",
        "scheduledFor": "2026-10-06T13:00:00.000Z",
        "timezone": "America/New_York",
        "liveUrls": [],
        "lastError": null
      }
    ],
    "assets": [
      {
        "id": "das_123",
        "externalId": "short-1",
        "version": 1,
        "status": "ready",
        "lastError": null
      },
      {
        "id": "das_124",
        "externalId": "short-1-cover",
        "version": 1,
        "status": "ready",
        "lastError": null
      }
    ]
  }
}

Vous débutez avec l'API Synup ?