提交網絡評估

接口概述

提交跨境連線需求，由 WiseLink 團隊跟進評估。此接口不會自動開通線路或產生報價。

接口資訊

網絡評估 · 提交網絡評估

POST /v1/network-assessments

認證方式：請求需在 Header 中攜帶 Authorization: Bearer <API_KEY>。建立類請求必須包含 Content-Type: application/json，推薦傳入 Idempotency-Key 避免重複提交。

請求參數

下表列出此接口支援的所有輸入參數及約束條件：

參數名稱	類型	約束	說明
organization_name	string	必填	企業名稱，不可為空。
regions	string[]	必填	涉及的地區代碼，例如 HK、SG；至少一項。
current_environment	string	必填	目前的網絡、雲端及企業系統概況。
objectives	string	必填	需要改善的連線或資料流。

請求正文範例 · application/json

{
  "organization_name": "Example Trading",
  "regions": [
    "HK",
    "SG"
  ],
  "current_environment": "香港辦公室連接新加坡雲端系統",
  "objectives": "改善跨地域資料交換的穩定性"
}

成功回應

狀態碼：201 Created

參數名稱	類型	約束	說明
id	string	必填	評估 ID。
status	string	必填	建立時為 submitted。
created_at	string	必填	建立時間，ISO 8601 UTC 格式。
request_id	string	必填	本次請求的追蹤 ID。

回應正文範例 · application/json

{
  "id": "na_01JEXAMPLE",
  "status": "submitted",
  "created_at": "2026-09-29T08:00:00Z",
  "request_id": "req_03JEXAMPLE"
}

調用示例

將 <API_BASE_URL> 替換為 WiseLink 分配的端點地址，將 <API_KEY> 替換為您的訪問金鑰：

請求示例 · cURL

curl -X POST "<API_BASE_URL>/v1/network-assessments" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <UNIQUE_KEY>" \
  -d '{"organization_name":"Example Trading","regions":["HK","SG"],"current_environment":"香港辦公室連接新加坡雲端系統","objectives":"改善跨地域資料交換的穩定性"}'

注意事項

submitted 表示需求已收取；後續評估由服務團隊處理。
地區代碼只用於描述需求，不代表當地服務一定可用。

錯誤處理

錯誤響應說明

參數無效時返回 400 VALIDATION_ERROR；憑證缺失或失效返回 401 UNAUTHORIZED；無權訪問返回 403 FORBIDDEN；指定資源不存在返回 404 NOT_FOUND。完整錯誤碼與指數退避策略請參閱錯誤與重試指南。