> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/ja/developers/api/quickstart.md).

# クイックスタート

> API トークンを発行し、BoxHero API に最初のリクエストを送信します。

このガイドでは、トークンの発行から最初の API 呼び出しの成功までを説明します。

## 1. API トークンを発行する

デスクトップのウェブアプリで連携したいチームを開き、`設定` > `連携設定`に移動します。新しい API トークンを生成してコピーします。

![](https://assets.boxhero.io/docs/images/e6bbc8fa4eab21ec0f9ebe74893cd3a6e0c6a5d4d178ae02478ef99adbe4c4cd-2214x1431.jpg)

> **Caution**
>
> **注意**: トークンは発行したチームに紐づき、API を通じてそのチームのデータに完全にアクセスできます。トークンはサーバー上で保管し、モバイルアプリやブラウザのコード、公開リポジトリには絶対に含めないでください。

## 2. 最初のリクエストを送信する

[連携チームの取得](https://www.boxhero.io/docs/ja/developers/api/reference/teams/get-linked-team)を呼び出して、トークンが機能することを確認します。トークンは `Authorization` ヘッダーで送信します。

```bash
curl https://rest.boxhero-app.com/v1/teams/linked \
  -H "Authorization: Bearer $BOXHERO_API_TOKEN"
```

レスポンスには、トークンが属するチームの情報が含まれます。

```json
{
  "id": 149058,
  "name": "Acme Retail",
  "mode": 2,
  "currency_symbol": "$",
  "currency_code": "USD",
  "price_decimal_places": 2,
  "memo": null
}
```

代わりに `401` が返された場合は、トークンが送信されていないか、コピーが不完全です。エラーの形式については[エラー](https://www.boxhero.io/docs/ja/developers/api/errors)をご覧ください。

> **Note**
>
> ほとんどのエンドポイントは、[ロケーション](https://www.boxhero.io/docs/ja/concepts/locations)で在庫を管理するチームでのみ使用できます。それ以外のチームでは `/errors/invalid-team-mode` タイプのエラーが返されます。ロケーションモードのチームでは、上記のレスポンスの `mode` が `2` になります。

## 3. 次のステップ

- [商品一覧の取得](https://www.boxhero.io/docs/ja/developers/api/reference/items/list-items)で在庫を一覧表示し、[ページネーション](https://www.boxhero.io/docs/ja/developers/api/pagination)ですべてのページを取得する方法を確認します。
- [履歴の作成](https://www.boxhero.io/docs/ja/developers/api/reference/transactions/create-transaction)で在庫の変動を記録します。ルールについては[履歴](https://www.boxhero.io/docs/ja/developers/api/reference/transactions)をご覧ください。
- ポーリングの代わりに [Webhook](https://www.boxhero.io/docs/ja/developers/webhooks/overview) で変更の通知を受け取ります。
- [API リファレンス](https://www.boxhero.io/docs/ja/developers/api/reference)ですべてのエンドポイントを確認します。