API リファレンス / 商品カテゴリ

カテゴリ作成

リクエスト例

curl -X POST "https://apiv2.thebase.com/api/item_categories" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "parent_id": 0
}'

リクエストボディ application/json

• namestring必須1 文字以上 / 30 文字以下
  カテゴリの表示名（1〜30 文字）。絵文字などの 4 バイト文字は使用できません。
• parent_idinteger任意nullable≥ 0
  親カテゴリの ID。省略または null の場合は最上位のカテゴリとして作成します。

レスポンス

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

• idinteger必須≥ 0
  作成されたカテゴリの ID

エラー

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

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