Beiträge

Einen Beitrag abrufen

Liefert einen Beitrag mit dem Zustand jedes Netzwerks, Link nach der Veröffentlichung und Fehler. Live jeden Beitrag des Workspace, im Test einen simulierten.

GEThttps://api.sofia-post.com/api/v1/posts/{id}

curl -X GET 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

Einen Beitrag abrufen

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

Lies einen Beitrag, um den Zustand jedes seiner Netzwerke zu verfolgen: Jedes Ziel wechselt zu published mit seinem Permalink oder zu failed mit seinem Grund. Um benachrichtigt zu werden, ohne die API abzufragen, registriere einen Webhook.

{
  "id": "efc578cc-ef79-40e9-876d-be1a33d3b8db",
  "status": "published",
  "targets": [
    {
      "platform": "instagram",
      "state": "published",
      "publishedAt": "2026-11-02T20:17:25.453Z",
      "permalink": "https://www.instagram.com/p/DfQJVPGFfb_/"
    }
  ]
}

Zustände

Zustand	Bedeutung
`draft`	Gespeichert, geht nicht raus
`scheduled`	Geht zu `scheduledAt` raus
`publishing`	Wird gerade an das Netzwerk gesendet
`published`	Online, mit seinem `permalink`
`failed`	Das Netzwerk hat ihn abgelehnt; `error` sagt, warum
`sent_to_inbox`	In die App des Netzwerks gesendet, wo der Inhaber ihn abschließt (TikTok)

Der status des Beitrags fasst seine Ziele zusammen. Er ist partial, wenn ein Netzwerk veröffentlicht hat und ein anderes gescheitert ist.

Autorisierungen

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

Pfadparameter

idstringerforderlich
Kennung des Beitrags.

Antwort

Der Beitrag und der Zustand jedes Ziels.

idstringerforderlich
Kennung des Beitrags
statusstringerforderlich
Über alle Netzwerke; partial: auf einem veröffentlicht, auf einem anderen fehlgeschlagen
Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstringerforderlich
Betrieb des Beitrags
createdAtstring<date-time>erforderlich
Wann der Beitrag erstellt wurde
targetsobject[]erforderlich
Ein Eintrag pro Netzwerk und Konto: zwei Konten in einem Netzwerk, zwei Einträge
Untergeordnete Attribute anzeigen
- platformstringerforderlich
  Netzwerk des Ziels
- accountIdstringerforderlich
  Das Konto, das veröffentlicht (GET /v1/establishments/:id/accounts)
- statestringerforderlich
  Zustand des Ziels in seinem Netzwerk
  Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  Wann das Ziel veröffentlicht wurde
- permalinkstring
  Link zum veröffentlichten Beitrag im Netzwerk
- errorstring
  Warum das Netzwerk abgelehnt hat
scheduledAtstring<date-time>
Wann der Beitrag zur Veröffentlichung geplant ist

War diese Seite hilfreich?