API リファレンス / 商品

在庫設定

リクエスト例

curl -X PUT "https://apiv2.thebase.com/api/items/123/stock" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
  "variation_id": 0,
  "count": 0
}'

パラメータ

リクエストボディ application/json

• variation_idinteger任意≥ 0
  対象の種類の ID。省略時は商品本体（種類を持たない商品）の在庫を指します。
• countinteger必須≥ 0 / ≤ 100000
  在庫数（絶対値、個、0 以上 100000 以下）

レスポンス

200 のレスポンスボディ（application/json）:

• variation_idinteger任意≥ 0
  対象の種類の ID。商品本体の在庫の場合はキーごと省略されます。
• countinteger必須≥ 0 / ≤ 100000
  在庫数（絶対値、個、0 以上 100000 以下）

エラー

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

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