Probelauf und Testmodus

POST /v1/posts?dry_run=true führt die Prüfungen einer echten Veröffentlichung aus: die Regeln jedes Netzwerks, das verbundene Konto, die Medien, das Datum und Ihren Tarif. Es speichert nichts und sendet nichts.

Bereit

Wenn jedes Netzwerk den Beitrag akzeptieren würde, lautet die Antwort 200 mit status: "ready" und für jedes Ziel dem Konto, das veröffentlichen würde.

Abgelehnt

Andernfalls lautet die Antwort 422 post_refused, mit einem Detail pro Grund. Jedes Detail nennt sein Netzwerk, seinen code und sagt, was zu korrigieren ist.

{
  "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"
  }
}

Jeder Grund ist in den Fehlern aufgeführt.

Testmodus

Eine im Test-Modus erstellte Anwendung (Tokens sofia_test_at_…) liest Ihren echten Workspace, schreibt aber nie hinein: Ihre Beiträge werden simuliert und nach denselben Regeln beurteilt, und jeder echte Schreibzugriff antwortet mit 403 live_mode_required. Schlüssel und Clients, die unter Einstellungen › API erstellt werden, sind live; nutzen Sie den Probelauf, um ohne Veröffentlichung zu prüfen.