Posting-APIAPI

Ein POST, um überall zu veröffentlichen

Erstelle einen Beitrag einmal, liste die Zielkonten auf, und FoPost übernimmt Formatierung, Medien-Upload und Zustellung für jedes Netzwerk. Schlüssel mit Scopes, idempotente Requests und ein Zustellstatus, den du abfragen oder per Webhook empfangen kannst.

API-Schlüssel holenDoku lesen
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Shipped a new release today." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

curl -X POST https://api.fopost.com/v1/posts/7d3e0a52-.../publish \
  -H "X-API-Key: $API_KEY"

Jedes Netzwerk, ein Format

Derselbe Request-Body veröffentlicht auf X, LinkedIn, Instagram und jedem anderen verbundenen Konto.

Schlüssel mit Scopes

Ein Schlüssel mit dem Scope publish kann posten und sonst nichts. Widerrufe ihn, ohne die anderen anzufassen.

Zustellung pro Konto

Jedes Konto meldet seinen eigenen Status, seine externe ID und seinen Permalink, sobald der Beitrag live ist.

Veröffentlichen

Schreib den Beitrag einmal, ziele auf beliebige Konten

Übergib Text, Medien und die Zielkonten. FoPost wendet die Limits und Konventionen jedes Netzwerks an, lädt Medien im von der Plattform gewünschten Format hoch und gibt eine Beitrags-ID zurück, die du verfolgen kannst. Threads, Karussells und Langtexte laufen alle über dasselbe content-Array.

Posting-Referenz lesen
Response
{
  "post_status": "publishing",
  "deliveries": [
    { "id": "a3c5e7f9-...", "account_id": "4a71d80b-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 },
    { "id": "b4d6f8a0-...", "account_id": "c30e9f12-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 }
  ],
  "health_warnings": []
}

Inhaltsblöcke

Geordnete Blöcke werden je nach Netzwerk zu einem Thread, einem Karussell oder einem Fließtext.

Medien per Referenz

Lade einmal in die Medienbibliothek hoch und hänge sie per ID an beliebig viele Beiträge an.

Idempotent

Sende einen Idempotenz-Schlüssel, und ein wiederholter Request postet nie doppelt.

Verfolgen

Wisse genau, wo jeder Beitrag gelandet ist

Ein Beitrag verteilt sich auf eine Zustellung pro Konto. Frag den Deliveries-Endpunkt ab oder abonniere einen Webhook, und du bekommst den Plattformstatus, die externe ID, den Permalink und den Fehlertext, wenn ein Netzwerk etwas ablehnt.

Webhook-Events ansehen
Verbundene Konten aller Netzwerke in einem Workspace

Deliveries-Endpunkt

GET /v1/posts/:id/deliveries listet jedes Konto mit seinem eigenen Status auf.

Webhook-Ereignisse

delivery.published und delivery.failed werden ausgelöst, sobald eine Zustellung abgeschlossen ist.

Wiederholungen eingebaut

Vorübergehende Plattformfehler werden mit Backoff wiederholt, bevor sie als fehlgeschlagen erscheinen.

Verwalten

Bearbeiten, abbrechen und löschen aus dem Code

Der gesamte Lebenszyklus liegt in der API. Aktualisiere einen geplanten Beitrag, bevor er rausgeht, brich ihn ab oder lösche einen veröffentlichten Beitrag aus dem Netzwerk, in dem er gelandet ist. Labels und Workspaces halten Kundenarbeit getrennt, wenn du mehr als eine Marke betreust.

Jetzt bauen
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": [{ "text": "Updated copy." }] }'

Vor der Veröffentlichung bearbeiten

Ändere Text, Medien oder Konten bei allem, was noch in der Warteschlange liegt.

Labels

Versieh Beiträge mit Labels nach Kampagne oder Kunde und filtere jeden Listen-Endpunkt danach.

Workspaces

Schlüssel gelten pro Workspace, ein Kunde kann also nie einen anderen erreichen.

Fragen zu Posting-API, beantwortet

Wie authentifiziere ich mich?

Erstelle im Dashboard unter Settings einen API-Schlüssel und sende ihn im Header X-API-Key. Jeder Schlüssel gehört zu einem Workspace und trägt nur die Scopes, die du ihm gibst.

In welchen Netzwerken kann ich posten?

Auf jedem Konto, das mit dem Workspace verbunden ist, in jedem Netzwerk, das FoPost unterstützt. Das Request-Format ist für alle gleich.

Kann ich Bilder und Videos anhängen?

Ja. Lade einmal über die Media API hoch und referenziere dann die Medien-ID im Beitrag. Größen- und Formatlimits pro Netzwerk werden für dich angewendet.

Was passiert, wenn ein Netzwerk ausfällt?

Die Zustellung wird mit Backoff wiederholt. Schlägt sie weiterhin fehl, wird sie mit dem Plattformfehler als fehlgeschlagen markiert, und ein delivery.failed-Webhook wird ausgelöst.

Gibt es ein Rate Limit?

Ja, 100 Requests pro Minute und Schlüssel. Limit und verbleibende Anzahl werden in den Response-Headern zurückgegeben.

Gibt es ein SDK?

Ein typisiertes TypeScript-SDK, ein MCP-Server für KI-Clients und kostenlose PHP-, Laravel- und WordPress-Pakete. Für jede andere Sprache wird die OpenAPI-Spezifikation von der API ausgeliefert.

Baue noch heute auf Posting-API

Der Start ist kostenlos und die vollständige API inklusive. Erstelle einen Schlüssel und mach in wenigen Minuten deinen ersten Aufruf.

API-Schlüssel holen