建立分析運算任務

POST /v1/analytics/jobs — 提交非同步數據分析、時序預測或異常檢測任務。

建立非同步數據分析運算任務。適用於大數據集時序預測 (forecasting)、多維異常偏離檢測 (anomaly_detection) 或客戶分群聚類 (clustering) 等高耗時運算場景。

接口基本資訊

POST/v1/analytics/jobs

本接口為異步調用，成功提交後返回 HTTP 202 Accepted 及專屬 `job_id`。運算完成後，系統將主動發送 Webhook 通知，或可通過查詢接口拉取最終指標。

請求參數規格

參數規格 (Parameters)

參數名稱	位置	類型	必填	說明
`task_type`	body	string	必填	任務類型枚舉: forecasting (時序預測), anomaly_detection (異常檢測), clustering (多維聚類)示例: forecasting
`dataset_id`	body	string	必填	已在 Pinnacle 平台註冊並校驗通過的數據集 UID示例: ds_bvi_corp_9921
`algorithm`	body	string	選填	運算演算法模型。forecasting 可選: prophet, arima, deepar；預設為 auto示例: prophet
`parameters`	body	object	選填	模型超參數配置，如 forecast_horizon (預測步長), confidence_interval (置信區間，如 0.95)示例: {"forecast_horizon": 90, "confidence_interval": 0.95}
`callback_url`	body	string	選填	自定義 Webhook 回調地址。若不傳則使用在控制台全局配置的默認 Webhook示例: https://client-api.enterprise.com/webhooks/pinnacle

多語言發起調用代碼示例

選擇您的後端技術棧直接複製完整對接代碼：

建立分析運算任務 (POST /v1/analytics/jobs)

curl -X POST "https://api.pinnacle-advisory.vg/v1/analytics/jobs" \
  -H "Authorization: Bearer sec_live_9a8b7c6d5e4f" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: idemp_job_$(date +%s)" \
  -d '{
    "task_type": "forecasting",
    "dataset_id": "ds_bvi_corp_9921",
    "algorithm": "prophet",
    "parameters": {
      "forecast_horizon": 90,
      "confidence_interval": 0.95
    }
  }'

成功響應範例 (202 Accepted)

HTTP 202 Accepted 響應體

{
  "status": "accepted",
  "request_id": "req_881923019283",
  "data": {
    "job_id": "job_fc_20260929_7712",
    "task_type": "forecasting",
    "dataset_id": "ds_bvi_corp_9921",
    "state": "queued",
    "estimated_seconds": 18,
    "created_at": "2026-09-29T08:45:00Z",
    "results_url": "https://api.pinnacle-advisory.vg/v1/analytics/jobs/job_fc_20260929_7712/results"
  }
}