# エラーレスポンス

BASE API のエラー（4xx / 5xx）は、すべて [RFC 9457 (Problem Details for HTTP APIs)](https://www.rfc-editor.org/rfc/rfc9457) に沿った `application/problem+json` のレスポンスボディで返します。クライアントはステータスコードと `type` の値でエラーを判別できます。

## レスポンスの構造

- `type` string（必須）: エラー種別の識別子（`/errors/{domain}/{error}` 形式の相対パス）
- `title` string（必須）: エラー種別の短い要約（英語）。`type` ごとに固定の文言です。
- `status` integer（必須 / ≥ 400 / ≤ 599）: HTTP ステータスコード
- `detail` string（任意）: この発生事象に固有の開発者向け説明（英語）
- `instance` string（任意）: この発生事象を識別する URI 参照
- `errors` ProblemFieldError[]（任意）: バリデーションエラー時のフィールド単位の詳細
  - `detail` string（必須）: 該当フィールドのエラー内容（英語）
  - `pointer` string（必須）: リクエストボディ内の該当箇所を指す JSON Pointer（RFC 6901、例: #/title）

例: 存在しない商品を指定した場合のレスポンス。

```
HTTP/1.1 404 Not Found
Content-Type: application/problem+json

{
  "type": "/errors/items/not-found",
  "title": "Item not found",
  "status": 404,
  "detail": "The item is not found."
}
```

## エラー種別（type）

`type` は `/errors/{リソース}/{理由}` 形式の安定した識別子です。同じステータスコードに複数のエラー種別が対応することがあるため、プログラムでの分岐にはステータスコードではなく `type` を使ってください。`title` は `type` ごとに固定の英語文言で、`detail` は発生した事象に応じて変わります。

### すべてのエンドポイントが返すエラー

認証されていない場合、要求スコープを満たさない場合、予期しない内部エラーが発生した場合に返します。

| Status | Type | Description |
| --- | --- | --- |
| `401` | `/errors/auth/unauthenticated` | 認証に失敗した、または認証情報が指定されていない場合に返します。 |
| `403` | `/errors/auth/forbidden` | アクセストークンにこのエンドポイントで必要なスコープが含まれていない場合に返します。 |
| `500` | `/errors/internal/unexpected` | サーバー内部で予期しないエラーが発生した場合に返します。 |

### エンドポイントごとに宣言されたエラー

リクエストの形式、リソースの状態、業務ルール、上流サービスの結果などに応じて返します。発生条件と説明は各エンドポイントページの「エラー」に記載しています。この表は、受け取った `type` からエンドポイントを逆引きするための索引です。

| Status | Type | Endpoints |
| --- | --- | --- |
| `400` | `/errors/files/invalid-body` | [POST /api/files](/docs/endpoints/post-api-files.md) |
| `400` | `/errors/item_categories/invalid-body` | [POST /api/item_categories](/docs/endpoints/post-api-item-categories.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md) |
| `400` | `/errors/items/invalid-body` | [POST /api/items](/docs/endpoints/post-api-items.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md) |
| `400` | `/errors/orders/invalid-body` | [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md), [POST /api/orders/search](/docs/endpoints/post-api-orders-search.md) |
| `400` | `/errors/request/invalid-params` | [DELETE /api/item_categories/{id}](/docs/endpoints/delete-api-item-categories-id.md), [GET /api/item_categories/{id}](/docs/endpoints/get-api-item-categories-id.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [DELETE /api/item_categories/{id}/items/{item_id}](/docs/endpoints/delete-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/items/{item_id}](/docs/endpoints/put-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md), [DELETE /api/items/{id}](/docs/endpoints/delete-api-items-id.md), [GET /api/items/{id}](/docs/endpoints/get-api-items-id.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [GET /api/items/{id}/images](/docs/endpoints/get-api-items-id-images.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [DELETE /api/items/{id}/images/{image_id}](/docs/endpoints/delete-api-items-id-images-image-id.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [GET /api/items/{id}/variations](/docs/endpoints/get-api-items-id-variations.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [DELETE /api/items/{id}/variations/{variation_id}](/docs/endpoints/delete-api-items-id-variations-variation-id.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md), [GET /api/orders/{unique_key}](/docs/endpoints/get-api-orders-unique-key.md), [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md) |
| `400` | `/errors/request/invalid-query` | [GET /api/items](/docs/endpoints/get-api-items.md) |
| `400` | `/errors/request/malformed-body` | [POST /api/files](/docs/endpoints/post-api-files.md), [POST /api/item_categories](/docs/endpoints/post-api-item-categories.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md), [POST /api/items](/docs/endpoints/post-api-items.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md), [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md), [POST /api/orders/search](/docs/endpoints/post-api-orders-search.md) |
| `404` | `/errors/item_categories/not-found` | [DELETE /api/item_categories/{id}](/docs/endpoints/delete-api-item-categories-id.md), [GET /api/item_categories/{id}](/docs/endpoints/get-api-item-categories-id.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [DELETE /api/item_categories/{id}/items/{item_id}](/docs/endpoints/delete-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/items/{item_id}](/docs/endpoints/put-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md) |
| `404` | `/errors/items/image-not-found` | [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [DELETE /api/items/{id}/images/{image_id}](/docs/endpoints/delete-api-items-id-images-image-id.md) |
| `404` | `/errors/items/not-found` | [DELETE /api/item_categories/{id}/items/{item_id}](/docs/endpoints/delete-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/items/{item_id}](/docs/endpoints/put-api-item-categories-id-items-item-id.md), [DELETE /api/items/{id}](/docs/endpoints/delete-api-items-id.md), [GET /api/items/{id}](/docs/endpoints/get-api-items-id.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [GET /api/items/{id}/images](/docs/endpoints/get-api-items-id-images.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [DELETE /api/items/{id}/images/{image_id}](/docs/endpoints/delete-api-items-id-images-image-id.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [GET /api/items/{id}/variations](/docs/endpoints/get-api-items-id-variations.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [DELETE /api/items/{id}/variations/{variation_id}](/docs/endpoints/delete-api-items-id-variations-variation-id.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md) |
| `404` | `/errors/items/variation-not-found` | [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [DELETE /api/items/{id}/variations/{variation_id}](/docs/endpoints/delete-api-items-id-variations-variation-id.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md) |
| `404` | `/errors/orders/not-found` | [GET /api/orders/{unique_key}](/docs/endpoints/get-api-orders-unique-key.md), [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md) |
| `404` | `/errors/user/not-found` | [GET /api/user](/docs/endpoints/get-api-user.md) |
| `413` | `/errors/request/body-too-large` | [POST /api/files](/docs/endpoints/post-api-files.md), [POST /api/item_categories](/docs/endpoints/post-api-item-categories.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md), [POST /api/items](/docs/endpoints/post-api-items.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md), [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md), [POST /api/orders/search](/docs/endpoints/post-api-orders-search.md) |
| `415` | `/errors/request/unsupported-media-type` | [POST /api/files](/docs/endpoints/post-api-files.md), [POST /api/item_categories](/docs/endpoints/post-api-item-categories.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md), [POST /api/items](/docs/endpoints/post-api-items.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md), [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md), [POST /api/orders/search](/docs/endpoints/post-api-orders-search.md) |
| `422` | `/errors/item_categories/invalid-list-order` | [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md) |
| `422` | `/errors/item_categories/write-rejected` | [POST /api/item_categories](/docs/endpoints/post-api-item-categories.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [DELETE /api/item_categories/{id}/items/{item_id}](/docs/endpoints/delete-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/items/{item_id}](/docs/endpoints/put-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md) |
| `422` | `/errors/items/file-content-mismatch` | [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md) |
| `422` | `/errors/items/file-not-uploaded` | [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md) |
| `422` | `/errors/items/image-limit-exceeded` | [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md) |
| `422` | `/errors/items/invalid-file-id` | [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md) |
| `422` | `/errors/items/invalid-image-order` | [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md) |
| `422` | `/errors/items/invalid-list-order` | [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md) |
| `422` | `/errors/items/invalid-variation-order` | [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md) |
| `422` | `/errors/items/lottery-not-deletable` | [DELETE /api/items/{id}](/docs/endpoints/delete-api-items-id.md) |
| `422` | `/errors/items/variation-id-required` | [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md) |
| `422` | `/errors/items/write-rejected` | [POST /api/items](/docs/endpoints/post-api-items.md), [DELETE /api/items/{id}](/docs/endpoints/delete-api-items-id.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [DELETE /api/items/{id}/images/{image_id}](/docs/endpoints/delete-api-items-id-images-image-id.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [DELETE /api/items/{id}/variations/{variation_id}](/docs/endpoints/delete-api-items-id-variations-variation-id.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md) |
| `422` | `/errors/orders/cancel-rejected` | [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md) |
| `422` | `/errors/orders/dispatch-rejected` | [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md) |
| `422` | `/errors/orders/dispatch-suspended` | [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md) |
| `422` | `/errors/orders/invalid-delivery` | [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md) |
| `422` | `/errors/orders/invalid-order-lines` | [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md) |
| `422` | `/errors/orders/kantan-delivery-not-dispatchable` | [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md) |
| `422` | `/errors/orders/not-cancellable` | [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md) |
| `422` | `/errors/orders/not-dispatchable` | [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md) |
| `422` | `/errors/orders/payment-maintenance` | [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md) |
| `422` | `/errors/orders/update-rejected` | [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md) |
| `502` | `/errors/internal/bad-gateway` | [POST /api/files](/docs/endpoints/post-api-files.md), [POST /api/item_categories](/docs/endpoints/post-api-item-categories.md), [DELETE /api/item_categories/{id}](/docs/endpoints/delete-api-item-categories-id.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [DELETE /api/item_categories/{id}/items/{item_id}](/docs/endpoints/delete-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/items/{item_id}](/docs/endpoints/put-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md), [POST /api/items](/docs/endpoints/post-api-items.md), [DELETE /api/items/{id}](/docs/endpoints/delete-api-items-id.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [DELETE /api/items/{id}/images/{image_id}](/docs/endpoints/delete-api-items-id-images-image-id.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [DELETE /api/items/{id}/variations/{variation_id}](/docs/endpoints/delete-api-items-id-variations-variation-id.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md), [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md), [POST /api/orders/search](/docs/endpoints/post-api-orders-search.md) |
| `504` | `/errors/internal/gateway-timeout` | [POST /api/files](/docs/endpoints/post-api-files.md), [POST /api/item_categories](/docs/endpoints/post-api-item-categories.md), [DELETE /api/item_categories/{id}](/docs/endpoints/delete-api-item-categories-id.md), [POST /api/item_categories/{id}](/docs/endpoints/post-api-item-categories-id.md), [DELETE /api/item_categories/{id}/items/{item_id}](/docs/endpoints/delete-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/items/{item_id}](/docs/endpoints/put-api-item-categories-id-items-item-id.md), [PUT /api/item_categories/{id}/list_order](/docs/endpoints/put-api-item-categories-id-list-order.md), [POST /api/items](/docs/endpoints/post-api-items.md), [DELETE /api/items/{id}](/docs/endpoints/delete-api-items-id.md), [POST /api/items/{id}](/docs/endpoints/post-api-items-id.md), [POST /api/items/{id}/images](/docs/endpoints/post-api-items-id-images.md), [PUT /api/items/{id}/images](/docs/endpoints/put-api-items-id-images.md), [DELETE /api/items/{id}/images/{image_id}](/docs/endpoints/delete-api-items-id-images-image-id.md), [PUT /api/items/{id}/list_order](/docs/endpoints/put-api-items-id-list-order.md), [PUT /api/items/{id}/stock](/docs/endpoints/put-api-items-id-stock.md), [POST /api/items/{id}/variations](/docs/endpoints/post-api-items-id-variations.md), [PUT /api/items/{id}/variations](/docs/endpoints/put-api-items-id-variations.md), [DELETE /api/items/{id}/variations/{variation_id}](/docs/endpoints/delete-api-items-id-variations-variation-id.md), [POST /api/items/{id}/variations/{variation_id}](/docs/endpoints/post-api-items-id-variations-variation-id.md), [PUT /api/items/{id}/visibility](/docs/endpoints/put-api-items-id-visibility.md), [PUT /api/orders/{unique_key}](/docs/endpoints/put-api-orders-unique-key.md), [POST /api/orders/{unique_key}/cancel](/docs/endpoints/post-api-orders-unique-key-cancel.md), [PUT /api/orders/{unique_key}/customer](/docs/endpoints/put-api-orders-unique-key-customer.md), [PUT /api/orders/{unique_key}/delivery](/docs/endpoints/put-api-orders-unique-key-delivery.md), [POST /api/orders/{unique_key}/dispatch](/docs/endpoints/post-api-orders-unique-key-dispatch.md), [PUT /api/orders/{unique_key}/shipping](/docs/endpoints/put-api-orders-unique-key-shipping.md), [PUT /api/orders/{unique_key}/shop_memo](/docs/endpoints/put-api-orders-unique-key-shop-memo.md), [POST /api/orders/search](/docs/endpoints/post-api-orders-search.md) |

## バリデーションエラー

リクエストボディやパラメータがエンドポイントのスキーマを満たさない場合は 400 を返し、`errors` 配列にフィールド単位の内訳を含めます。各要素の `pointer` は問題のあったフィールドを指す JSON Pointer（RFC 6901）です。

```
HTTP/1.1 400 Bad Request
Content-Type: application/problem+json

{
  "type": "/errors/items/invalid-body",
  "title": "Request body validation failed",
  "status": 400,
  "errors": [
    {
      "detail": "Invalid input: expected string, received undefined",
      "pointer": "#/name"
    }
  ]
}
```