查詢網絡評估
GET /v1/network-assessments/{assessment_id}
接口概述
查看網絡評估的處理狀態。具體建議由 WiseLink 團隊與客戶確認。
接口資訊
GET /v1/network-assessments/{assessment_id}認證方式：請求需在 Header 中攜帶 Authorization: Bearer <API_KEY>。 資源 ID 透過 URL 路徑參數傳遞。
請求參數
下表列出此接口支援的所有輸入參數及約束條件：
| 參數名稱 | 類型 | 約束 | 說明 |
|---|---|---|---|
| assessment_id | path string | 必填 | 提交評估後取得的 ID。 |
成功回應
狀態碼：200 OK
| 參數名稱 | 類型 | 約束 | 說明 |
|---|---|---|---|
| id | string | 必填 | 評估 ID。 |
| status | string | 必填 | submitted、under_review 或 completed。 |
| updated_at | string | 必填 | 最近更新時間，ISO 8601 UTC 格式。 |
| request_id | string | 必填 | 本次查詢的追蹤 ID。 |
{
"id": "na_01JEXAMPLE",
"status": "under_review",
"updated_at": "2026-09-30T04:00:00Z",
"request_id": "req_04JEXAMPLE"
}調用示例
將 <API_BASE_URL> 替換為 WiseLink 分配的端點地址，將 <API_KEY> 替換為您的訪問金鑰：
curl -X GET "<API_BASE_URL>/v1/network-assessments/{assessment_id}" \
-H "Authorization: Bearer <API_KEY>" \注意事項
- completed 表示評估流程完成，不代表線路已開通。
- 不存在或無權查看的 ID 均返回 404。
錯誤處理
錯誤響應說明
參數無效時返回
400 VALIDATION_ERROR；憑證缺失或失效返回 401 UNAUTHORIZED；無權訪問返回 403 FORBIDDEN；指定資源不存在返回 404 NOT_FOUND。完整錯誤碼與指數退避策略請參閱 錯誤與重試指南。