開発者向け
AI予測API
売上・需要・離反を予測し、発注や広告配信を自動最適化します。機械学習モデルによる予測結果をAPI経由で取得できます。
api/v1/store/aiforecast
APIリファレンスで確認
エンドポイント一覧
| メソッド | パス | 説明 | レスポンス |
|---|---|---|---|
| POST |
/api/v1/store/aiforecast/sales
|
売上予測
店舗・商品・カテゴリごとの将来の売上を予測します。
|
200 |
| POST |
/api/v1/store/aiforecast/demand
|
需要予測
販売トレンド、季節性、外部シグナルを使って商品レベルの需要を予測します。
|
200 |
| POST |
/api/v1/store/aiforecast/churn
|
顧客離反予測
非アクティブになりそうな顧客を予測します。
|
200 |
| POST |
/api/v1/store/aiforecast/recommendations
|
商品レコメンデーション
顧客の購買履歴に基づいたパーソナライズされた商品提案を返します。
|
200 |
エンドポイント詳細
店舗・商品・カテゴリごとの将来の売上を予測します。
完全パス：
POST /api/v1/store/aiforecast/sales
レスポンスコード：
200
販売トレンド、季節性、外部シグナルを使って商品レベルの需要を予測します。
完全パス：
POST /api/v1/store/aiforecast/demand
レスポンスコード：
200
非アクティブになりそうな顧客を予測します。
完全パス：
POST /api/v1/store/aiforecast/churn
レスポンスコード：
200
顧客の購買履歴に基づいたパーソナライズされた商品提案を返します。
完全パス：
POST /api/v1/store/aiforecast/recommendations
レスポンスコード：
200
リクエスト例
リクエスト
POST /api/v1/store/aiforecast/sales
Authorization: Bearer {access_token}
{
"storeId": "store-001",
"period": "2025-04",
"category": "飲料"
}
レスポンス
{
"storeId": "store-001",
"period": "2025-04",
"predictedSales": 2840000,
"confidence": 0.87,
"topProducts": [
{ "name": "緑茶500ml", "predicted": 1200 },
{ "name": "コーヒーM", "predicted": 980 }
]
}
認証について
このAPIを利用するには、Authorization: Bearer {access_token} ヘッダーが必要です。
トークンの取得方法は認証ガイドをご確認ください。