認証

APIトークンを作成し、Bearerヘッダーでリクエストを認証します。

更新日: 2026年10月29日

前提条件： 問い合わせる組織にアクセスできるアカウントが必要です。

APIトークンの作成

APIトークンは個人用です。組織の管理画面ではなく自分のアカウントから作成し、作成者と同じアクセス権を持ちます。

複数のトークンを作成でき、どのトークンも同じ画面から取り消せます。

各リクエストのAuthorizationヘッダーにトークンを指定します。

Authorization: Bearer <your-token>

有効なトークンがない場合は、WWW-Authenticate: Bearerヘッダーを含む401 Unauthorizedが返されます。

{ "errors": ["Access denied"] }

ほとんどのエンドポイントはorganization_idのパスパラメータを必要とします。次のリクエストで取得できます。

GET /v1/organizations
Authorization: Bearer <your-token>

レスポンスは組織名とIDの対応表です。

{
  "Acme Manufacturing": 12,
  "Acme Tooling": 15
}

以降のリクエストでは、この数値IDを使います。

GET /v1/organizations/12/machines
Authorization: Bearer <your-token>

正しい組織の有効なトークンがあっても、すべてのレコードが見えるとは限りません。組織内のリソースごとの権限により、範囲がさらに制限されます。

この制限はリソースごとに適用されます。例えばpartsとmachinesの権限は独立しています。書込みだけでなく、すべての一覧・詳細エンドポイントで確認されます。

失敗時には次のステータスが返されます。

ステータス	意味
`401 Unauthorized`	トークンが未指定・無効、または所有者が操作を許可されていない場合。どちらも`403`ではなく`401`です。未指定・無効の場合は`"Access denied"`、権限不足の場合は`"You are not authorized to perform this action"`となります。存在しない`organization_id`は、トークンが届かない組織と同じく権限不足になります。
`404 Not Found`	レコードが存在しない、または別の組織に属する場合。
`422 Unprocessable Entity`	検証失敗。本文に項目のエラーを含みます。

404の本文にある形式の不一致を含め、詳細はエラーを参照してください。