Crea l'app
- 1In PostNimbo apri Settings > Apps e crea un'app OAuth con nome, descrizione, immagine e indirizzo di reindirizzamento.
- 2Copia il client id e il client secret. Tieni il secret sul tuo server; se viene esposto, rigeneralo dalla stessa pagina.
Il flusso authorization code
Invia il membro alla schermata di consenso con il tuo client id, l'indirizzo di reindirizzamento, un valore state e una challenge PKCE S256, consigliata per tutte le app e obbligatoria per quelle che non possono custodire 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
Dopo l'approvazione, PostNimbo reindirizza al tuo indirizzo con code e state. Verifica lo state, poi scambia il code entro pochi minuti:
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"
}Invia l'access token nell'header Authorization della REST API. Continua a funzionare finché il membro non revoca la tua app; conservalo cifrato.
Scope
Chiedi solo ciò che la tua app usa. La schermata di consenso elenca ciascuno scope con queste parole. Se non ne chiedi nessuno, il token ottiene accesso completo, quindi preferisci gli scope.
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
Cosa può fare il token
- Agisce come il membro che l'ha approvato: solo i suoi brand e canali, e i livelli di canale che il suo workspace gli ha assegnato.
- Quando il workspace richiede l'approvazione, i post che programma attendono gli approvatori come quelli del membro stesso.
- Una route fuori dai suoi scope restituisce 403. Chiedi al membro di accedere di nuovo per concedere di più.
