App erstellen
- 1Öffnen Sie in PostNimbo Einstellungen > Apps und erstellen Sie eine OAuth-App mit Name, Beschreibung, Bild und Weiterleitungsadresse.
- 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.
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:
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>
{
"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 libraryposts:readSee your brands, channels, scheduled posts and the posts waiting for approvalposts: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 featureslink-in-bio:writeAdd links to your link-in-bio pagesanalytics:readSee a summary of your analyticsinbox:readSee how many inbox conversations are unreadwebhooks: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.
