API 概覽

WiseLink API v1 是一套基於標準 HTTP/REST 架構構建的企業級編程接口，支援透過代碼以結構化方式提交 AI 文本摘要任務、發起跨境網絡連線評估及登記業務諮詢需求。

接口設計原則

遵循標準 HTTP 動詞（GET 查詢、POST 建立），資源路徑結構清晰且具可預測性。

使用服務端獨立發放的 API Key 進行請求校驗，支援沙箱環境與生產環境安全隔離。

建立類 POST 請求強制支援 Idempotency-Key 標頭，防止網絡超時重試重複建立資源。

每次請求均派發並返回全局唯一 request_id，技術問題排查可做到精確日誌定位。

項目	約定規則	說明
傳輸協議	HTTPS (TLS 1.2 / 1.3)	所有明文 HTTP 請求將被直接拒絕
基礎 URL	https://<API_BASE_URL>/v1	由 WiseLink 開通後發放（沙箱/正式分開）
內容類型	application/json; charset=utf-8	所有 POST 正文與回應數據均為 UTF-8 JSON
時間戳格式	ISO 8601 (UTC)	範例：`2026-09-29T08:00:00Z`

WiseLink API 目前涵蓋以下核心端點，點擊可直接進入接口交互詳情頁：

分組	請求方式	端點路徑	功能說明
AI 任務	POST	/v1/ai/tasks	建立 AI 任務
AI 任務	GET	/v1/ai/tasks/{task_id}	查詢 AI 任務
網絡評估	POST	/v1/network-assessments	提交網絡評估
網絡評估	GET	/v1/network-assessments/{assessment_id}	查詢網絡評估
服務需求	POST	/v1/service-requests	提交服務需求

API 成功調用時返回標準 JSON 對象，包含業務字段及全局追蹤號：

成功回應範例 (HTTP 200/201/202)

{
  "id": "task_01JEXAMPLE",
  "status": "queued",
  "created_at": "2026-09-29T08:00:00Z",
  "request_id": "req_01JEXAMPLE"
}

Idempotency-Key 運作機制

當客戶端向 POST 接口提交資源時，建議在 Header 中傳入唯一的 Idempotency-Key（如 UUID v4）。若因網絡抖動、客戶端超時導致重新發送同一請求，服務端將識別該 Key 並返回第一次執行的結果，有效防止重複建立對象或重複觸發後續流程。

查看 Bearer API Key 傳遞規範與多語言請求示例。

了解完整 HTTP 狀態碼、業務錯誤代碼與重試算法。

學習如何高效率輪詢長耗時 AI 與網絡評估任務。