メーカー・店舗向け
顧客・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"
}