Aller au contenu
Développeurs

Applications OAuth

Permettez à d’autres utilisateurs de PostNimbo de connecter votre produit. Ils se connectent, voient ce que vous demandez, l’approuvent et peuvent le révoquer à tout moment dans Paramètres > Applications.

Créer l’application

  1. 1Dans PostNimbo, ouvrez Paramètres > Applications et créez une application OAuth avec son nom, sa description, son image et son adresse de redirection.
  2. 2Copiez le client id et le client secret. Gardez le secret sur votre serveur ; régénérez-le depuis la même page en cas de fuite.

Le flux authorization code

Envoyez le membre vers l’écran de consentement avec votre client id, l’adresse de redirection, une valeur state et un challenge PKCE S256, recommandé pour toutes les applications et obligatoire pour celles qui ne peuvent pas garder un secret.

1. Ouvrir l’écran de consentement
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

Après son approbation, PostNimbo redirige vers votre adresse avec code et state. Vérifiez le state, puis échangez le code dans les quelques minutes qui suivent :

2. Échangez le code
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. La réponse
{
  "access_token": "pos_…",
  "token_type": "bearer",
  "scope": "posts:read posts:schedule"
}

Envoyez le jeton d’accès dans l’en-tête Authorization de l’API REST. Il reste valable jusqu’à ce que le membre révoque votre application ; stockez-le chiffré.

Portées

Ne demandez que ce que votre application utilise. L’écran de consentement liste chaque scope avec ces mots. Si vous n’en demandez aucun, le jeton obtient un accès complet : privilégiez donc les 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

Ce que le jeton peut faire

  • Il agit au nom du membre qui l’a approuvé : uniquement ses marques et ses canaux, avec les niveaux d’accès aux canaux que son espace de travail lui a donnés.
  • Quand l’espace de travail exige une approbation, les publications qu’il programme attendent les approbateurs, comme celles du membre.
  • Une route hors de ses scopes renvoie 403. Demandez au membre de se reconnecter pour accorder davantage.

Vous créez quelque chose avec PostNimbo ?

Dites-nous ce que vous préparez. Nous vous aidons avec l’API, examinons les applications pour l’annuaire et ajoutons les endpoints dont les intégrations ont besoin.