Vercel 管理 API 指南 (v1.2)

GIIP 平台提供用於管理 Vercel 項目配置和查詢部署歷史記錄的 API。該 API 預設採用 Sk3 (基於 JSON 數據) 介面來處理請求。

🔌 前往 Vercel 狀態頁 →

📋 概述

Vercel 管理 API 用於查詢在 GIIP 中註冊的 Vercel 項目設置，或監控最新的部署歷史。

🔐 認證與安全

所有請求都必須包含 GIIP 通用身份驗證標頭。

• 標頭 (Header): x-giip-ak, x-giip-sk
• 請求體上下文 (Body Context): Sk3 介面（使用 jsondata 欄位）

📡 API 詳情 (Sk3)

1. 查詢 Vercel 配置清單 (VercelConfigsList)

• 命令: text=VercelConfigsList
• jsondata: {"csn": 123} (可選：項目標識符)
• 說明: 返回目前註冊的所有 Vercel 配置資訊以及關聯的 Vercel 項目名稱。

2. 創建 Vercel 配置 (VercelConfigCreate)

• 命令: text=VercelConfigCreate
• jsondata:

{
  "csn": 123,
  "configName": "Production_Main",
  "vercelProjectName": "giip-next-app",
  "vercelToken": "vcl_token_...",
  "vercelTeamId": "team_xxx",
  "vercelProjectId": "prj_xxx"
}

3. 修改/刪除 Vercel 配置 (VercelConfigUpdate / VercelConfigDelete)

• 修改: text=VercelConfigUpdate + {"vcId": 123, ...}
• 刪除: text=VercelConfigDelete + {"vcSn": 123} (或 vcId)

4. 查詢部署歷史 (VercelDeploymentsList)

• 命令: text=VercelDeploymentsList
• jsondata: {"vcId": 123, "limit": 20}
• 說明: 按時間倒序查詢對應特定配置 (vcId) 的 Vercel 部署清單。

🛡️ 巧用 Sk3 (高性能日誌)

Vercel 管理 API 從設計階段起就將 giipApiSk3 介面作為標準。它為所有配置管理和查詢請求提供詳細的執行上下文和錯誤追蹤。

• 端點: https://giipfaw.azurewebsites.net/api/giipApiSk3
• 優勢: 當發生 Vercel 令牌 (Token) 錯誤或部署狀態同步失敗時，會自動記錄調用者的 IP、User-Agent 以及詳細的服務端堆栈跟蹤 (StackTrace)，幫助您迅速診斷集成問題。
• 使用技巧: 在發送如 VercelConfigCreate 等包含大量參數的請求時，利用 jsondata 物件結構可以確保複雜的令牌值安全、完整地傳輸，並保留詳細日誌。

🔧 疑難排解

症狀	原因	解決
請求因認證錯誤被拒絕	缺少 x-giip-ak / x-giip-sk 請求頭或金鑰錯誤	包含有效的認證請求頭後重試
text 命令無法識別或返回空回應	text 值拼寫錯誤(例如 VercelConfigList 與 VercelConfigsList)	確認準確的命令名並設定到 text 參數中
部署清單為空或同步失敗	vercelToken 已過期或無效	透過 VercelConfigUpdate 更新有效令牌後重新查詢
VercelDeploymentsList 無返回結果	vcId 錯誤，或該配置無部署歷史	使用 VercelConfigsList 確認正確的 vcId 後重試

---

版本: 1.3 最後更新: 2026-04-11 源碼: giipv3/public/help/api-vercel.zh-TW.md

---

相關文檔:

• API 結果代碼指南 (RstVal)