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

GET /v1/customers

scope

read_customers

リクエストパラメーター

名前位置必須説明
limitクエリinteger任意
offsetクエリinteger任意

レスポンスの例

{
"data": [
{
"id": "42",
"line_uid": "string",
"name": "山田太郎",
"avatar_url": "string",
"is_blocked": true
}
],
"pagination": {
"limit": 0,
"offset": 0,
"total": 0
}
}

解説

顧客を一覧取得します。LINE 識別(line_uid・表示名・画像・ブロック状態)のみで、氏名等の個人情報は含みません。

エラーレスポンスの例

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

返しうるエラー: 401 / 403