Beiträge

Einen Beitrag veröffentlichen

Live-Apps veröffentlichen sofort, planen oder speichern einen Entwurf; Test-Apps simulieren nur. Mit ?dry_run=true wird alles geprüft und nichts geschrieben.

POSThttps://api.sofia-post.com/api/v1/posts

POST/v1/posts

API-Schlüssel oder Access-TokenNur in diesem Tab gespeichert und nur an api.sofia-post.com gesendet.dry_run (query)Idempotency-Key (header)Request-Body

Diese Anfrage wirkt auf Ihr echtes Konto.

curl -X POST 'https://api.sofia-post.com/api/v1/posts' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"establishmentId":"cmvy2k3m40001ms4rest00000","targets":[{"platform":"instagram","text":"Tarte tatin du jour","format":"post","accountId":"cmvy2k3m40001ms4rig000000"}],"scheduledAt":"2026-11-02T10:00:00.000Z"}'

Autorisierungen

Authorizationstringerforderlich
Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Abfrageparameter

dry_runstring
true: führt jede Prüfung des Versands aus (Netzwerkregeln, Konten, Medien, Erstellung, Live-Abonnement) und schreibt nichts. Liefert 200 ready oder 422 post_refused.
Zulässige Werte: truefalse

Header

Idempotency-Keystring
Mit demselben Body wiederholt, liefert die Anfrage dieselbe Antwort, ohne einen zweiten Beitrag zu erstellen. Ein Probelauf verbraucht den Schlüssel nicht.

Body

application/json

establishmentIdstringerforderlich
Betrieb, im Workspace der Autorisierung des Tokens (GET /v1/establishments)
targetsobject[]erforderlich
Ein Netzwerk pro Ziel
Untergeordnete Attribute anzeigen
- platformstringerforderlich
  Ziel-Netzwerk
  Zulässige Werte: instagramfacebookxlinkedintiktok
- textstringerforderlich
  In diesem Netzwerk veröffentlichte Bildunterschrift
- mediaobject[]
  Angehängte Medien
  Untergeordnete Attribute anzeigen
  - idstring
    Kennung eines Mediums der Mediathek des Betriebs (sonst url und type)
  - urlstring
    Öffentliche Adresse des Mediums (live https); ohne Kennung
  - typestring
    Art des per Adresse angegebenen Mediums
    Zulässige Werte: imagevideo
- formatstring
  Format (post, reel, story, carousel...); standardmäßig das, das das Netzwerk liefern würde
- accountIdstring
  Live: das verbundene Konto, das veröffentlicht, wenn der Betrieb mehrere in diesem Netzwerk hat (GET /v1/establishments/:id/accounts)
scheduledAtstring<date-time>
Planungsdatum (ISO 8601), in der Zukunft; fehlt es: sofort veröffentlichen. Nicht erlaubt mit status draft
statusstring
draft: ein Entwurf (nur live), ohne Datum erstellt, nichts wird gesendet; PATCH /v1/posts/:id plant ihn
Zulässige Werte: draft

Antwort

200application/json

Probelauf: Alle Prüfungen bestanden.

statusstringerforderlich
Immer ready
Zulässige Werte: ready
dryRunbooleanerforderlich
Immer true
Zulässige Werte: true
targetsobject[]erforderlich
Die geprüften Ziele
Untergeordnete Attribute anzeigen
- platformstringerforderlich
  Netzwerk des Ziels
- statestringerforderlich
  Immer ready
  Zulässige Werte: ready
- accountIdstring
  Live: das Konto, das veröffentlichen würde
- handlestring
  Live: sein angezeigtes Handle

201application/json

Live: publishing oder scheduled. Test: simulated.

idstringerforderlich
Kennung des Beitrags, zum Zurücklesen mit GET /v1/posts/:id
statusstringerforderlich
Zustand des Beitrags bei der Erstellung
Zulässige Werte: draftpublishingscheduled
establishmentIdstringerforderlich
Betrieb des Beitrags
targetsobject[]erforderlich
Die Ziele des Beitrags
Untergeordnete Attribute anzeigen
- platformstringerforderlich
  Netzwerk des Ziels
- accountIdstringerforderlich
  Das Konto, das veröffentlicht
- statestringerforderlich
  Zustand des Ziels bei der Erstellung
  Zulässige Werte: draftpublishingscheduledfailed
scheduledAtstring<date-time>
Wann der Beitrag zur Veröffentlichung geplant ist

400

Fehlerhafter Body.

401

Das Token fehlt, ist unbekannt, abgelaufen oder widerrufen.

402

subscription_required (live, Probelauf eingeschlossen).

403

Dem Token fehlt die Berechtigung posts:write.

404

establishment_not_found: außerhalb des Workspace des Tokens.

422application/json

post_refused: Ein Netzwerk, der Betrieb oder die Erstellung würde ablehnen; media_import_refused (live) mit Grund; idempotency_key_reused.

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.