Zum Inhalt springen
Entwickler

OAuth-Apps

Lassen Sie andere PostNimbo-Nutzer Ihr Produkt verbinden. Sie melden sich an, sehen, was Sie anfragen, genehmigen es und können es jederzeit unter Einstellungen > Apps widerrufen.

App erstellen

  1. 1Öffnen Sie in PostNimbo Einstellungen > Apps und erstellen Sie eine OAuth-App mit Name, Beschreibung, Bild und Weiterleitungsadresse.
  2. 2Kopieren Sie Client-ID und Client-Secret. Bewahren Sie das Secret auf Ihrem Server auf; erneuern Sie es auf derselben Seite, falls es bekannt wird.

Der Authorization-Code-Flow

Schicken Sie das Mitglied zum Zustimmungsbildschirm, mit Ihrer Client-ID, der Weiterleitungsadresse, einem state-Wert und einer PKCE-S256-Challenge – empfohlen für jede App und Pflicht für Apps, die kein Secret geheim halten können.

1. Zustimmungsseite öffnen
https://postnimbo.com/oauth/authorize
  ?client_id=<client id>
  &response_type=code
  &redirect_uri=<your redirect address>
  &state=<random value>
  &code_challenge=<base64url(sha256(verifier))>
  &code_challenge_method=S256
  &scope=posts:read posts:schedule

Nach der Genehmigung leitet PostNimbo mit code und state an Ihre Adresse weiter. Prüfen Sie den state und tauschen Sie den code innerhalb weniger Minuten ein:

2. Code eintauschen
curl -X POST https://postnimbo.com/api/oauth/token \
  -d grant_type=authorization_code \
  -d code=<code> \
  -d client_id=<client id> \
  -d client_secret=<client secret> \
  -d code_verifier=<verifier> \
  -d redirect_uri=<your redirect address>
3. Die Antwort
{
  "access_token": "pos_…",
  "token_type": "bearer",
  "scope": "posts:read posts:schedule"
}

Senden Sie das Zugriffstoken im Authorization-Header der REST API. Es funktioniert, bis das Mitglied Ihre App widerruft; speichern Sie es verschlüsselt.

Scopes

Fragen Sie nur an, was Ihre App nutzt. Der Zustimmungsbildschirm listet jeden Scope mit diesen Worten auf. Wird keiner angefragt, erhält das Token Vollzugriff – nutzen Sie also lieber Scopes.

  • ideas:writeSave ideas to your Ideas board, and remove ideas you saved (Undo)
  • media:writeAdd images to your media library
  • posts:readSee your brands, channels, scheduled posts and the posts waiting for approval
  • posts:scheduleSchedule posts to your channels (when your workspace asks for approval, your approvers get them first)
  • ai:useWrite drafts with PostNimbo AI, within your plan's AI features
  • link-in-bio:writeAdd links to your link-in-bio pages
  • analytics:readSee a summary of your analytics
  • inbox:readSee how many inbox conversations are unread
  • webhooks:writeSend an event to an address you choose (like Zapier, Make or n8n) when a post is published, a flow captures a lead (with its email or phone number) or a flow is completed

Was das Token darf

  • Es handelt als das Mitglied, das es genehmigt hat: nur dessen Marken und Kanäle, mit den Kanalstufen, die der Workspace ihm gegeben hat.
  • Verlangt der Workspace Freigaben, warten damit geplante Beiträge auf die Freigebenden, genau wie die eigenen Beiträge des Mitglieds.
  • Eine Route außerhalb der Scopes ergibt 403. Bitten Sie das Mitglied, sich erneut anzumelden, um mehr zu gewähren.

Sie bauen etwas mit PostNimbo?

Erzählen Sie uns, woran Sie arbeiten. Wir helfen bei der API, prüfen Apps für das Verzeichnis und ergänzen die Endpunkte, die Integrationen brauchen.