コンテンツへスキップ
開発者

OAuthアプリ

ほかのPostNimboユーザーがあなたの製品を接続できるようにします。ユーザーはサインインして要求内容を確認・承認し、Settings > Apps からいつでも取り消せます。

アプリを作成する

  1. 1PostNimboで Settings > Apps を開き、名前、説明、画像、リダイレクト先アドレスを指定してOAuthアプリを作成します。
  2. 2クライアントIDとクライアントシークレットをコピーします。シークレットはサーバーで保管し、漏えいした場合は同じページから再発行してください。

認可コードフロー

クライアントID、リダイレクト先アドレス、state値、そしてPKCE S256チャレンジを付けて、メンバーを同意画面に送ります。PKCEはすべてのアプリに推奨され、シークレットを保管できないアプリでは必須です。

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を確認し、数分以内にcodeを交換してください。

2. 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. レスポンス
{
  "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 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についてのサポート、ディレクトリ掲載アプリの審査、連携に必要なエンドポイントの追加を行います。