Simulation et mode test

Obtenir une clé API

POST /v1/posts?dry_run=true exécute les contrôles d’une vraie publication : les règles de chaque réseau, le compte connecté, les médias, la date et votre forfait. Il n’enregistre rien et n’envoie rien.

Prête

Quand chaque réseau accepterait la publication, la réponse est 200 avec status: "ready" et, pour chaque cible, le compte qui publierait.

Refusée

Sinon, la réponse est 422 post_refused, avec un détail par raison. Chaque détail nomme son réseau, son code, et dit quoi corriger.

json
{
  "error": {
    "code": "post_refused",
    "message": "The post would not be published: x: the text is too long (300 characters, at most 280)",
    "details": [
      {
        "platform": "x",
        "code": "caption_too_long",
        "max": 280,
        "actual": 300,
        "message": "x: the text is too long (300 characters, at most 280)"
      }
    ],
    "docUrl": "https://www.sofia-post.com/developers/errors#post_refused"
  }
}

Chaque raison est listée dans les erreurs.

Mode test

Une application créée en mode test (jetons sofia_test_at_…) lit votre vrai Workspace mais n’y écrit jamais : ses publications sont simulées et jugées selon les mêmes règles, et toute écriture réelle répond 403 live_mode_required. Les clés et clients créés dans Réglages › API sont en mode live ; utilisez la simulation pour vérifier sans publier.