Simulazione e modalità test

Ottieni una chiave API

POST /v1/posts?dry_run=true esegue i controlli di una vera pubblicazione: le regole di ogni rete, l'account collegato, i media, la data e il tuo piano. Non salva nulla e non invia nulla.

Pronta

Quando ogni rete accetterebbe la pubblicazione, la risposta è 200 con status: "ready" e, per ogni destinazione, l'account che pubblicherebbe.

Rifiutata

Altrimenti la risposta è 422 post_refused, con un dettaglio per motivo. Ogni dettaglio nomina la sua rete, il suo code, e dice cosa correggere.

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

Ogni motivo è elencato negli errori.

Modalità test

Un'applicazione creata in modalità test (token sofia_test_at_…) legge il tuo vero Workspace ma non vi scrive mai: le sue pubblicazioni sono simulate e giudicate con le stesse regole, e qualsiasi scrittura reale risponde 403 live_mode_required. Le chiavi e i client creati in Impostazioni › API sono live; usa la simulazione per verificare senza pubblicare.