# 入門

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

Source: https://support.toolingmetrics.com/ja/api/getting-started/
Updated: 2026-10-23

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

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

<a id="step-1-generate-an-api-token"></a>

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

1. Tooling Metricsで、サイドバー下部のアバター → **設定** → **APIトークン**タブを開きます。
2. **APIトークンを新規作成**をクリックします。
3. このトークンの名前を入力します（例：`erp-integration`、`cam-plugin`）。
4. **作成**をクリックします。トークンは一度だけ表示されます。すぐにコピーしてください。再表示はできません。

<a id="step-2-find-your-organization-id"></a>

## ステップ2：組織IDの確認

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

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

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

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

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

<a id="step-3-make-your-first-request"></a>

## ステップ3：最初のリクエストの送信

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

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

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

<a id="step-4-handle-errors"></a>

## ステップ4：エラーの処理

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

```json
{ "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`の不一致を含む詳細は[エラー](https://support.toolingmetrics.com/ja/api/errors/)を参照してください。

詳細なリファレンスは[エラー](https://support.toolingmetrics.com/ja/api/errors/)を参照してください。

<a id="next-steps"></a>

## 次のステップ

- [基本概念](https://support.toolingmetrics.com/ja/api/concepts/) — 組織によるアクセス範囲、ページ分割、日時形式、読取り専用リソース。
- ガイド（未公開）— CAM連携、ERP同期、生産の自動化の手順。現在の対応範囲は[基本概念](https://support.toolingmetrics.com/ja/api/concepts/)を参照してください。
- [リファレンス](https://support.toolingmetrics.com/ja/api/reference/) — エンドポイントの詳細。