Vai al contenuto
Sviluppatori

App OAuth

Permetti ad altri utenti di PostNimbo di collegare il tuo prodotto. Accedono, vedono cosa chiedi, lo approvano e possono revocarlo in qualsiasi momento da Settings > Apps.

Crea l'app

  1. 1In PostNimbo apri Settings > Apps e crea un'app OAuth con nome, descrizione, immagine e indirizzo di reindirizzamento.
  2. 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.

1. Apri la schermata di consenso
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:

2. Scambia il 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 risposta
{
  "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 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

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ù.

Stai creando qualcosa con PostNimbo?

Raccontaci cosa stai realizzando. Ti aiutiamo con l'API, esaminiamo le app per la directory e aggiungiamo gli endpoint di cui le integrazioni hanno bisogno.