# DELETE /api/items/{id}

商品削除

指定した商品を削除します。

商品はショップに表示されなくなり、紐づく種類・在庫・画像も参照できなくなります。
また、次の設定も解除されます。

- 予約商品・商品オプション・配送方法
- コミュニティ限定・販売期間
- 販売パートナーへの出品・商品の並び順

削除は取り消せません。
抽選販売が進行中の商品は削除できません。
既に削除された商品を指定した場合は、存在しない商品として扱います。

## 要求スコープ

- `items.delete`
- `items.read`

## パラメータ

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | `string` | 必須 | 商品 ID（1 以上の整数を文字列で表したもの） |

## リクエスト例

```sh
curl -X DELETE "https://apiv2.thebase.com/api/items/123" \
  -H "Authorization: Bearer <your-token>"
```

## レスポンス

| Status | Description |
| --- | --- |
| `204` | 削除成功。レスポンス body は持ちません。 |

## エラー

エラーは `application/problem+json` の Problem 形式で返します。認証・スコープ・予期しない内部エラーなど、すべてのエンドポイントに共通のエラーと構造・判別方法は [エラーレスポンス](/docs/errors.md) を参照してください。

このエンドポイントが返すその他のエラーは次のとおりです。

| Status | Type | Description |
| --- | --- | --- |
| `400` | `/errors/request/invalid-params` | 1 つ以上のパスパラメータがエンドポイントのスキーマを満たさない場合に返します。 |
| `404` | `/errors/items/not-found` | 指定した商品が存在しない、または呼び出し元から参照できない場合に返します。1 リクエストで複数の商品を指定するエンドポイント（並び順の変更など）では、そのいずれかが参照できない場合に返します。 |
| `422` | `/errors/items/lottery-not-deletable` | 抽選販売が進行中（応募の受付が始まっており、抽選結果の発表も販売の中止もされていない）の商品を削除しようとした場合に返します。抽選結果を発表するか販売を中止すると削除できるようになります。 |
| `422` | `/errors/items/write-rejected` | 商品の作成・編集・削除を業務ルールにより実行できない場合に返します (型整合性違反、種別不可変、ドメイン制約違反など)。細分化された Problem type に対応しない理由のときに返します。 |
| `502` | `/errors/internal/bad-gateway` | BASE API が処理を完了するために必要な内部処理で不整合が発生した場合に返します。 |
| `504` | `/errors/internal/gateway-timeout` | BASE API が処理を完了するために必要な内部処理が制限時間内に完了しなかった場合に返します。 |