カテゴリに商品を追加

指定したカテゴリに商品を 1 件追加します。

対象のカテゴリは id、商品は item_id で指定できます。 既にそのカテゴリに登録されている場合も成功します。

PUT /api/item_categories/{id}/items/{item_id}
スコープ items.readitems.update

リクエスト例

curl
curl -X PUT "https://apiv2.thebase.com/api/item_categories/123/items/456" \
  -H "Authorization: Bearer <your-token>"

パラメータ

id string · path 必須
カテゴリ ID(1 以上の整数を文字列で表したもの)
item_id string · path 必須
商品 ID(1 以上の整数を文字列で表したもの)

レスポンス

204 追加成功。

エラー

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

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

400 /errors/request/invalid-params 1 つ以上のパスパラメータがエンドポイントのスキーマを満たさない場合に返します。
404 /errors/item_categories/not-found 指定したカテゴリが存在しない、または呼び出し元から参照できない場合に返します。
404 /errors/items/not-found 指定した商品が存在しない、または呼び出し元から参照できない場合に返します。1 リクエストで複数の商品を指定するエンドポイント(並び順の変更など)では、そのいずれかが参照できない場合に返します。
422 /errors/item_categories/write-rejected カテゴリの作成・編集、またはカテゴリと商品の結びつけを業務ルールにより実行できない場合に返します (親カテゴリが存在しない、階層の上限を超える、同じ階層に同名のカテゴリが既にある、など)。
502 /errors/internal/bad-gateway BASE API が処理を完了するために必要な内部処理で不整合が発生した場合に返します。
504 /errors/internal/gateway-timeout BASE API が処理を完了するために必要な内部処理が制限時間内に完了しなかった場合に返します。