アプリを作成する
- 1PostNimboで Settings > Apps を開き、名前、説明、画像、リダイレクト先アドレスを指定してOAuthアプリを作成します。
- 2クライアントIDとクライアントシークレットをコピーします。シークレットはサーバーで保管し、漏えいした場合は同じページから再発行してください。
認可コードフロー
クライアントID、リダイレクト先アドレス、state値、そしてPKCE S256チャレンジを付けて、メンバーを同意画面に送ります。PKCEはすべてのアプリに推奨され、シークレットを保管できないアプリでは必須です。
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を確認し、数分以内に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>
{
"access_token": "pos_…",
"token_type": "bearer",
"scope": "posts:read posts:schedule"
}アクセストークンはREST APIのAuthorizationヘッダーで送信します。メンバーがアプリを取り消すまで有効なので、暗号化して保存してください。
スコープ
アプリで使うものだけを要求してください。同意画面には、それぞれが以下の文言で表示されます。何も要求しないとトークンにフルアクセスが与えられるため、スコープの指定をおすすめします。
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を返します。権限を追加するには、メンバーにもう一度サインインしてもらってください。
