Перейти к содержимому
Разработчикам

OAuth-приложения

Дайте другим пользователям PostNimbo подключать ваш продукт. Они входят в систему, видят, что вы запрашиваете, одобряют это и могут в любой момент отозвать доступ в разделе Settings > Apps.

Создайте приложение

  1. 1В PostNimbo откройте Settings > Apps и создайте OAuth-приложение, указав название, описание, изображение и адрес перенаправления.
  2. 2Скопируйте client id и client secret. Храните секрет на своём сервере; если он утёк, замените его на той же странице.

Поток с кодом авторизации

Отправьте участника на экран согласия с вашим client id, адресом перенаправления, значением state и PKCE-вызовом S256 — он рекомендуется для любого приложения и обязателен для приложений, которые не могут хранить секрет.

1. Откройте экран согласия
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

После одобрения PostNimbo перенаправляет на ваш адрес с параметрами code и state. Проверьте state, затем обменяйте код в течение нескольких минут:

2. Обменяйте код
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. Ответ
{
  "access_token": "pos_…",
  "token_type": "bearer",
  "scope": "posts:read posts:schedule"
}

Передавайте токен доступа в заголовке Authorization запросов к REST API. Он действует, пока участник не отзовёт доступ вашего приложения; храните его в зашифрованном виде.

Области доступа

Запрашивайте только то, что использует ваше приложение. На экране согласия каждая область описана этими словами. Если не запросить ни одной, токен получит полный доступ, поэтому лучше указывать области.

  • 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

Что может токен

  • Он действует от имени одобрившего его участника: только его бренды и каналы и те уровни доступа к каналам, которые ему дало рабочее пространство.
  • Если в рабочем пространстве включено одобрение, запланированные токеном посты ждут согласующих так же, как посты самого участника.
  • Маршрут вне его областей доступа возвращает 403. Чтобы получить больше прав, попросите участника войти снова.

Создаёте что-то на базе PostNimbo?

Расскажите, что вы делаете. Мы помогаем с API, проверяем приложения для каталога и добавляем эндпоинты, которые нужны интеграциям.