Skip to main content
「申請(Application)」表示目前帳戶對某個服務的訂閱關係——必須先申請,才能再為這個申請建立 API 憑證、呼叫業務介面。首次申請某個服務時,Application 會獲得該服務目前設定的 free_amount;該值可能為 0。
ℹ️ 本介面屬於 AceDataCloud 平台管理 API,統一前綴 https://platform.acedata.cloud/api/v1/。完整介面索引請見取得 AceDataCloud 平台文件列表。

完整的串接流程

新使用者從註冊到串通第一個業務介面,通常會走這 5 步:
  1. 取得帳戶權杖 → 管理 AceDataCloud 平台帳戶權杖
  2. 挑選服務 → 取得 AceDataCloud 平台服務列表
  3. 建立申請(本文檔) → 依服務設定取得初始額度
  4. 建立 API 憑證 → 建立 AceDataCloud 平台 API 憑證
  5. 呼叫業務介面 → 使用取得的 32 位 Token 呼叫 https://api.acedata.cloud/<path>

介面概覽

驗證說明(如何取得帳戶權杖)

請求標頭:
帳戶權杖(Account Token)是開發者透過 API 管理自己帳戶資源的「帳號級金鑰」。取得方式:
  1. 控制台一鍵建立(推薦):登入 AceDataCloud 平台 → Account Token 控制台 → 點選「建立」即可取得以 platform-v1- 開頭的權杖。
  2. API 建立:使用現有的帳戶權杖或瀏覽器登入狀態 JWT 呼叫 POST /api/v1/platform-tokens/,詳見管理 AceDataCloud 平台帳戶權杖。
⚠️ 帳戶權杖與密碼同等敏感,禁止寫入前端程式碼或公開儲存庫。一旦洩漏,立即在控制台刪除並重建。

請求本體

請求範例

cURL

Python

Node.js

回應範例

成功(HTTP 201)

回傳欄位結構與取得 AceDataCloud 平台服務申請詳情一致。

已申請過(HTTP 400)

這是設計上的硬性限制:每位使用者對每個服務只能有一個 Application。已存在時,透過取得 AceDataCloud 平台服務申請列表尋找現有的。

服務不存在(HTTP 404)

服務需要審核(HTTP 403)

如果服務的 need_verify=true(可在服務列表中看到該欄位),需走工單流程申請白名單。

錯誤處理

錯誤回應統一格式:

實用提示

  • 建立本身不扣款:首次建立時依服務目前的 free_amount 設定初始額度;該值可能為 0,且再次建立同類 Application 不保證重複贈送。
  • 是否需要付費請看 paid 欄位:剛申請時 paid=false,呼叫建立 AceDataCloud 平台儲值訂單完成付款後變為 true。
  • disabled=true 表示被暫時停用——例如風控觸發、欠費等。被停用時業務介面會回傳 403。
  • 不要無限制並行建立:先從分頁服務列表取得目標 service_id,再依業務需求逐項申請;遇到 duplication 時重複使用既有的 Application。

相關介面