Pular para o conteúdo
Desenvolvedores

Apps OAuth

Deixe outros usuários do PostNimbo conectarem seu produto. Eles fazem login, veem o que você pede, aprovam e podem revogar a qualquer momento em Settings > Apps.

Crie o app

  1. 1No PostNimbo, abra Settings > Apps e crie um app OAuth com nome, descrição, imagem e endereço de redirecionamento.
  2. 2Copie o client id e o client secret. Mantenha o secret no seu servidor; se ele vazar, gere um novo na mesma página.

O fluxo authorization code

Envie o membro para a tela de consentimento com seu client id, o endereço de redirecionamento, um valor de state e um desafio PKCE S256, recomendado para todo app e obrigatório para apps que não conseguem guardar um secret.

1. Abra a tela de consentimento
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

Depois que ele aprovar, o PostNimbo redireciona para o seu endereço com code e state. Verifique o state e troque o code em poucos minutos:

2. Troque o 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. A resposta
{
  "access_token": "pos_…",
  "token_type": "bearer",
  "scope": "posts:read posts:schedule"
}

Envie o token de acesso no header Authorization da API REST. Ele continua funcionando até o membro revogar seu app; armazene-o criptografado.

Escopos

Peça apenas o que seu app usa. A tela de consentimento lista cada um com estas palavras. Não pedir nenhum dá acesso total ao token, então prefira usar escopos.

  • 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

O que o token pode fazer

  • Ele age como o membro que o aprovou: apenas as marcas e os canais dele, e os níveis de canal que o workspace lhe deu.
  • Quando o workspace exige aprovação, os posts que ele agenda aguardam os aprovadores como os do próprio membro.
  • Uma rota fora dos seus escopos retorna 403. Peça ao membro que faça login de novo para conceder mais.

Está criando algo com o PostNimbo?

Conte o que você está fazendo. Ajudamos com a API, analisamos apps para o diretório e adicionamos os endpoints de que as integrações precisam.