メインコンテンツまでスキップ

GET /v1/categories

scope

read_items

リクエストパラメーター

名前位置必須説明
parent_idクエリinteger任意filter by parent category

レスポンスの例

{
"data": [
{
"id": "1",
"parent_id": "string",
"name": "string",
"status": "active",
"sort": 0
}
]
}

解説

カテゴリを一覧取得します(parent_id で子カテゴリを絞り込み)。階層は 2 段まで。

エラーレスポンスの例

{
"error": {
"code": "insufficient_scope",
"message": "requires scope 'read_orders'",
"request_id": "req_01H..."
}
}

返しうるエラー: 401 / 403