コンシューマー向け

お気に入り店舗API

コンシューマー（エンドユーザー）向けのお気に入り店舗管理APIです。お気に入りの一覧取得・追加・削除、および特定店舗のお気に入り状態の確認に対応しています。OAuth 2.0のuser.favorites.*スコープが必要です。

api/v1/user/favorites ดูในเอกสารอ้างอิง API

รายการเอนด์พอยต์

เมธอด พาธ คำอธิบาย การตอบกลับ
GET /api/v1/user/favorites お気に入り店舗一覧を取得
ログインユーザーがお気に入り登録している店舗の一覧を返します。スコープ: user.favorites.read
 200 401 403
GET /api/v1/user/favorites/{storeId} お気に入り状態を確認
指定した店舗がお気に入り登録済みかどうかを返します。スコープ: user.favorites.read
 200 401
POST /api/v1/user/favorites/{storeId} 店舗をお気に入りに追加
指定した店舗をお気に入りに追加します。すでに登録済みの場合も安全に呼び出せます（冪等）。スコープ: user.favorites.write
 200 401 403
DELETE /api/v1/user/favorites/{storeId} お気に入りから削除
指定した店舗をお気に入りから削除します（論理削除）。スコープ: user.favorites.write
 204 404 401

รายละเอียดเอนด์พอยต์

ログインユーザーがお気に入り登録している店舗の一覧を返します。スコープ: user.favorites.read

พาธแบบเต็ม: GET /api/v1/user/favorites
รหัสการตอบกลับ: 200 401 403

指定した店舗がお気に入り登録済みかどうかを返します。スコープ: user.favorites.read

พาธแบบเต็ม: GET /api/v1/user/favorites/{storeId}
รหัสการตอบกลับ: 200 401

指定した店舗をお気に入りに追加します。すでに登録済みの場合も安全に呼び出せます（冪等）。スコープ: user.favorites.write

พาธแบบเต็ม: POST /api/v1/user/favorites/{storeId}
รหัสการตอบกลับ: 200 401 403

指定した店舗をお気に入りから削除します（論理削除）。スコープ: user.favorites.write

พาธแบบเต็ม: DELETE /api/v1/user/favorites/{storeId}
รหัสการตอบกลับ: 204 404 401

ตัวอย่างคำขอ

คำขอ 
GET /api/v1/user/favorites
Authorization: Bearer {access_token}
การตอบกลับ 
[
  {
    "userId": "usr-001",
    "storeId": "store-abc",
    "isActive": true,
    "createdAt": "2026-01-10T09:00:00Z",
    "updatedAt": "2026-01-10T09:00:00Z"
  }
]
เกี่ยวกับการยืนยันตัวตน

การใช้ API นี้ต้องมีเฮดเดอร์ Authorization: Bearer {access_token} โปรดดูวิธีขอ token ได้ที่คู่มือการยืนยันตัวตน

ดู API การยืนยันตัวตนและการเข้าถึง
ไปที่เอกสารอ้างอิง API