端點清單
| 方法 | 路徑 | 說明 | 回應 |
|---|---|---|---|
| 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 }
]
}