メーカー・店舗向け

顧客・CRM API

顧客属性・購買傾向・LTVを取得し、セグメントマーケティングに活用できます。顧客プロフィールの管理と購買履歴の取得が可能です。

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

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

เมธอด พาธ คำอธิบาย การตอบกลับ
GET /api/v1/store/customers/{id} 顧客プロフィールを取得
デモグラフィック情報、ロイヤルティ情報、購買統計を含む顧客プロフィールを取得します。
 200 404
GET /api/v1/store/customers 顧客を検索
デモグラフィック、ロイヤルティランク、行動属性でフィルタリングして検索します。
 200
POST /api/v1/store/customers 顧客を作成・更新（Upsert）
新しい顧客を作成するか、顧客IDに基づいて既存レコードを更新します。
 200
GET /api/v1/store/customers/{id}/purchases 顧客の購買履歴を取得
顧客に紐づく最近のレシート一覧を返します。
 200
DELETE /api/v1/store/customers/{id} 顧客プロフィールを削除
CRMシステムから顧客レコードを削除します。
 204 404

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

デモグラフィック情報、ロイヤルティ情報、購買統計を含む顧客プロフィールを取得します。

พาธแบบเต็ม: GET /api/v1/store/customers/{id}
รหัสการตอบกลับ: 200 404

デモグラフィック、ロイヤルティランク、行動属性でフィルタリングして検索します。

พาธแบบเต็ม: GET /api/v1/store/customers
รหัสการตอบกลับ: 200

新しい顧客を作成するか、顧客IDに基づいて既存レコードを更新します。

พาธแบบเต็ม: POST /api/v1/store/customers
รหัสการตอบกลับ: 200

顧客に紐づく最近のレシート一覧を返します。

พาธแบบเต็ม: GET /api/v1/store/customers/{id}/purchases
รหัสการตอบกลับ: 200

CRMシステムから顧客レコードを削除します。

พาธแบบเต็ม: DELETE /api/v1/store/customers/{id}
รหัสการตอบกลับ: 204 404

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

คำขอ 
GET /api/v1/store/customers/{id}
Authorization: Bearer {access_token}
การตอบกลับ 
{
  "id": "cust-001",
  "name": "田中 太郎",
  "email": "tanaka@example.com",
  "rank": "Gold",
  "totalSpend": 156000,
  "visitCount": 42,
  "lastVisit": "2025-03-15"
}
เกี่ยวกับการยืนยันตัวตน

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

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