1. Auth
Cosmic Agency Ad Accounts API
  • Auth
    • 获取 tenant_access_token
      POST
    • Bearer probe
      GET
  • AdAccounts
    • List ad accounts (token-bound client only)
      GET
  • TopUpsList
    • List top-ups for token-bound client
      GET
    • Get one top-up (404 if other tenant)
      GET
  • FundTransfersList
    • List clear/deduct tickets for token-bound client
      GET
    • Get one fund transfer (404 if other tenant)
      GET
  • Insights
    • Daily spend for Meta ad accounts
      GET
    • Daily spend by country for Meta ad accounts
      GET
  • TopupAndBalance
    • Submit topup (aligns with New Top-up modal)
      POST
    • Balance clear → wallet (pending approval)
      POST
    • Partial deduct → wallet (pending approval)
      POST
  1. Auth

Bearer probe

GET
/api/v1/auth/ping
Hard rate limit: 10 requests / second per API client for this path. Over limit → 429 RATE_LIMITED + Retry-After.

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://www.cosmicads.app/api/v1/auth/ping' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200
application/json
OK
Bodyapplication/json

示例
{
    "code": 0,
    "msg": "ok",
    "data": {
        "ok": true,
        "client_id": "string",
        "client_name": "string",
        "scopes": [
            "string"
        ],
        "allowed_meta_ids": [
            "string"
        ],
        "expires_at": "string"
    },
    "request_id": "string"
}
🟠403
🟠429
修改于 2026-10-28 06:35:53
上一页
获取 tenant_access_token
下一页
List ad accounts (token-bound client only)
Built with