free_amount;該值可能為 0。
ℹ️ 本介面屬於 AceDataCloud 平台管理 API,統一前綴 https://platform.acedata.cloud/api/v1/。完整介面索引請見取得 AceDataCloud 平台文件列表。
完整的串接流程
新使用者從註冊到串通第一個業務介面,通常會走這 5 步:- 取得帳戶權杖 → 管理 AceDataCloud 平台帳戶權杖
- 挑選服務 → 取得 AceDataCloud 平台服務列表
- 建立申請(本文檔) → 依服務設定取得初始額度
- 建立 API 憑證 → 建立 AceDataCloud 平台 API 憑證
- 呼叫業務介面 → 使用取得的 32 位 Token 呼叫
https://api.acedata.cloud/<path>
介面概覽
驗證說明(如何取得帳戶權杖)
請求標頭:- 控制台一鍵建立(推薦):登入 AceDataCloud 平台 → Account Token 控制台 → 點選「建立」即可取得以
platform-v1-開頭的權杖。 - API 建立:使用現有的帳戶權杖或瀏覽器登入狀態 JWT 呼叫
POST /api/v1/platform-tokens/,詳見管理 AceDataCloud 平台帳戶權杖。
⚠️ 帳戶權杖與密碼同等敏感,禁止寫入前端程式碼或公開儲存庫。一旦洩漏,立即在控制台刪除並重建。
請求本體
請求範例
cURL
Python
Node.js
回應範例
成功(HTTP 201)
已申請過(HTTP 400)
服務不存在(HTTP 404)
服務需要審核(HTTP 403)
need_verify=true(可在服務列表中看到該欄位),需走工單流程申請白名單。
錯誤處理
錯誤回應統一格式:
實用提示
- 建立本身不扣款:首次建立時依服務目前的
free_amount設定初始額度;該值可能為 0,且再次建立同類 Application 不保證重複贈送。 - 是否需要付費請看
paid欄位:剛申請時paid=false,呼叫建立 AceDataCloud 平台儲值訂單完成付款後變為true。 disabled=true表示被暫時停用——例如風控觸發、欠費等。被停用時業務介面會回傳403。- 不要無限制並行建立:先從分頁服務列表取得目標
service_id,再依業務需求逐項申請;遇到duplication時重複使用既有的 Application。
相關介面
- 取得 AceDataCloud 平台服務列表 — 先挑選服務
- 取得 AceDataCloud 平台服務申請列表 — 查看已申請的全部項目
- 取得 AceDataCloud 平台服務申請詳情 — 查看單一申請
- 建立 AceDataCloud 平台 API 憑證 — 申請成功後的下一步
- 建立 AceDataCloud 平台儲值訂單 — 免費額度用完後儲值

