入門

5分以内にトークンを作成し、最初のAPIリクエストを送信します。

更新日: 2026年10月23日

必要なもの： 少なくとも1つの組織にアクセスできるTooling Metricsアカウント。

Tooling Metrics APIはHTTPS上のJSON REST APIです。すべてのリクエストにBearerトークンが必要です。

ステップ1：APIトークンの作成

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

curl https://api.toolingmetrics.com/v1/organizations \
  -H "Authorization: Bearer YOUR_TOKEN"

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

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

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

組織の機械一覧を取得します。

curl https://api.toolingmetrics.com/v1/organizations/12/machines \
  -H "Authorization: Bearer YOUR_TOKEN"

JSON配列を伴う200 OKが返れば、認証とアクセス範囲の確認は正常です。

APIエラーはJSONを返し、ほとんどはerrors配列を使います。

{ "errors": ["Description of what went wrong"] }

ステータス	原因	対応
`401`	トークンが未指定・無効、または有効でもリソースの権限がない（存在しない`organization_id`を含む）	メッセージを確認します。トークンがない場合は認証を求めるメッセージ、権限不足の場合は「You are not authorized to perform this action」と表示されます。
`404`	レコードが存在しない、または別の組織に属する	IDと、レコードがURLの`organization_id`の組織に属することを確認します。存在しない`organization_id`は`401`になります。本文のキーは`errors`ではなく単数形の`error`です。
`422`	検証失敗	レスポンスの`errors`配列を確認します。
`429`	レート制限超過	`Retry-After`秒待って再試行します。

このAPIには403がありません。トークン未指定・無効と、有効でも権限不足の場合は、どちらも401となり、メッセージだけで区別します。errorとerrorsの不一致を含む詳細はエラーを参照してください。

詳細なリファレンスはエラーを参照してください。