Créer l’application
- 1Dans PostNimbo, ouvrez Paramètres > Applications et créez une application OAuth avec son nom, sa description, son image et son adresse de redirection.
- 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.
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 :
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"
}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 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
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.
