查詢分析指標結果

GET /v1/analytics/jobs/{id}/results — 獲取已完成運算任務的多維聚合指標與結果。

查詢已完成分析任務的多維聚合指標與結果。包含模型收斂評估、預測走勢數值、異常偏離矩陣及關鍵統計摘要。

接口基本資訊

GET/v1/analytics/jobs/{id}/results

當任務狀態處於 `completed` 時，本接口返回具體運算產出。若任務仍在 `queued` 或 `running` 階段，將返回當前進度百分比。

路徑與查詢參數

參數規格 (Parameters)

參數名稱	位置	類型	必填	說明
`id`	path	string	必填	任務專屬 UID示例: job_fc_20260929_7712
`format`	query	string	選填	導出數據格式: json (預設), csv, parquet示例: json
`limit`	query	integer	選填	返回指標點最大數量，預設 500，最大 5000示例: 100

多語言查詢調用示例

查詢指標結果 (GET /v1/analytics/jobs/{id}/results)

curl -X GET "https://api.pinnacle-advisory.vg/v1/analytics/jobs/job_fc_20260929_7712/results?limit=100" \
  -H "Authorization: Bearer sec_live_9a8b7c6d5e4f" \
  -H "Accept: application/json"

響應結構範例 (200 OK)

HTTP 200 OK 預測結果載荷

{
  "status": "success",
  "request_id": "req_881923019812",
  "state": "completed",
  "data": {
    "job_id": "job_fc_20260929_7712",
    "model_evaluation": {
      "algorithm_used": "prophet",
      "mape": 0.042,
      "rmse": 1120.5,
      "converged": true
    },
    "summary": {
      "total_points": 90,
      "trend_direction": "upward",
      "projected_growth_pct": 14.8
    },
    "series": [
      {
        "timestamp": "2026-10-01T00:00:00Z",
        "yhat": 154200.0,
        "yhat_lower": 148900.0,
        "yhat_upper": 159800.0
      },
      {
        "timestamp": "2026-10-02T00:00:00Z",
        "yhat": 155100.0,
        "yhat_lower": 149500.0,
        "yhat_upper": 160900.0
      }
    ]
  }
}