パートナーAPI

パートナー(外部スタッフ)のアクセストークン管理とスコープ設定を行うAPIエンドポイントです。

POST /api/v1/partners/tokens

パートナー用のアクセストークンを発行します。

// リクエスト
{
  "staff_id": "staff_001",
  "project_ids": ["prj_abc123"],
  "scopes": ["orders:read", "deliveries:write", "comments:write"],
  "expires_in_days": 90
}

// レスポンス (201 Created)
{
  "token": "pat_xxxxxxxxxxxxxxxx",
  "portal_url": "https://portal.animatime.com/t/pat_xxxx",
  "expires_at": "2026-06-20T00:00:00Z"
}

利用可能なスコープ

スコープ説明
orders:read発注伝票の閲覧
deliveries:write納品物のアップロード
comments:writeコメントの投稿
profile:read自身のプロフィール閲覧

DELETE /api/v1/partners/tokens/[id]

アクセストークンを無効化します。無効化後、パートナーはポータルにアクセスできなくなります。