Создайте приложение
- 1В PostNimbo откройте Settings > Apps и создайте OAuth-приложение, указав название, описание, изображение и адрес перенаправления.
- 2Скопируйте client id и client secret. Храните секрет на своём сервере; если он утёк, замените его на той же странице.
Поток с кодом авторизации
Отправьте участника на экран согласия с вашим client id, адресом перенаправления, значением state и PKCE-вызовом S256 — он рекомендуется для любого приложения и обязателен для приложений, которые не могут хранить секрет.
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, затем обменяйте код в течение нескольких минут:
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"
}Передавайте токен доступа в заголовке Authorization запросов к REST API. Он действует, пока участник не отзовёт доступ вашего приложения; храните его в зашифрованном виде.
Области доступа
Запрашивайте только то, что использует ваше приложение. На экране согласия каждая область описана этими словами. Если не запросить ни одной, токен получит полный доступ, поэтому лучше указывать области.
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
Что может токен
- Он действует от имени одобрившего его участника: только его бренды и каналы и те уровни доступа к каналам, которые ему дало рабочее пространство.
- Если в рабочем пространстве включено одобрение, запланированные токеном посты ждут согласующих так же, как посты самого участника.
- Маршрут вне его областей доступа возвращает 403. Чтобы получить больше прав, попросите участника войти снова.
