店舗向け

売上分析・予測API

売上の推移と予測、離反しやすい顧客、次に薦める商品を返します。店舗ダッシュボードが使っているものと同じ分析です。

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

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

เมธอด พาธ คำอธิบาย การตอบกลับ
GET /api/v1/sales/kpis 主要指標を取得
売上・客数・客単価を期間で取得します。
 200
GET /api/v1/sales/trend 売上推移を取得
日次・週次・月次の推移を取得します。
 200
GET /api/v1/sales/forecast 売上を予測
直近の実績から今後の売上を予測します。
 200
GET /api/v1/sales/churn 離反リスクを取得
しばらく来店のない顧客を、離反しやすい順に返します。
 200
GET /api/v1/sales/recommendations 推奨商品を取得
顧客ごとの購買傾向から次に薦める商品を返します。
 200
GET /api/v1/sales/advice 改善アドバイスを取得
数字の変化を文章にして返します。
 200
GET /api/v1/sales/products 商品別売上を取得
売れ筋と死に筋を返します。
 200
GET /api/v1/sales/visitors 来店分析を取得
曜日・時間帯別の来店傾向を返します。
 200

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

売上・客数・客単価を期間で取得します。

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

日次・週次・月次の推移を取得します。

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

直近の実績から今後の売上を予測します。

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

しばらく来店のない顧客を、離反しやすい順に返します。

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

顧客ごとの購買傾向から次に薦める商品を返します。

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

数字の変化を文章にして返します。

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

売れ筋と死に筋を返します。

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

曜日・時間帯別の来店傾向を返します。

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

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

คำขอ 
GET /api/v1/sales/forecast?storeId={storeId}
Authorization: Bearer {access_token}
การตอบกลับ 
{
  "storeId": "21cc…",
  "horizonDays": 30,
  "points": [
    { "date": "2026-09-01", "predictedAmount": 128400 }
  ]
}
เกี่ยวกับการยืนยันตัวตน

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

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