提交服務需求

接口概述

提交電訊諮詢、系統整合或 AI 服務需求。WiseLink 團隊會按提交內容聯絡對接人。

接口資訊

服務需求 · 提交服務需求

POST /v1/service-requests

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

請求參數

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

參數名稱	類型	約束	說明
service_type	string	必填	telecom_consulting、system_integration 或 ai_services。
organization_name	string	必填	企業名稱，不可為空。
contact_email	string	必填	對接人的工作電郵，須符合電郵格式。
description	string	必填	需求及現有環境的簡述，不可為空。

請求正文範例 · application/json

{
  "service_type": "system_integration",
  "organization_name": "Example Trading",
  "contact_email": "it@example.com",
  "description": "希望了解 CRM、ERP 與雲端系統的連接方式。"
}

成功回應

狀態碼：201 Created

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

回應正文範例 · application/json

{
  "id": "sr_01JEXAMPLE",
  "status": "received",
  "created_at": "2026-09-29T08:00:00Z",
  "request_id": "req_05JEXAMPLE"
}

調用示例

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

請求示例 · cURL

curl -X POST "<API_BASE_URL>/v1/service-requests" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <UNIQUE_KEY>" \
  -d '{"service_type":"system_integration","organization_name":"Example Trading","contact_email":"it@example.com","description":"希望了解 CRM、ERP 與雲端系統的連接方式。"}'

注意事項

received 表示已收到需求，不代表方案、價格或交付日期已確認。
請勿在 description 中提交密碼、金鑰或其他機密資料。

錯誤處理

錯誤響應說明

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