Get AceDataCloud Platform API Call Statistics

Get the recent call count statistics for a specific API endpoint (grouped by HTTP status code). This is public statistics that reflect the total call volume and success rate of the API on the platform — not an individual user's call records (for personal records, please refer to Get AceDataCloud Platform API Call Records).

ℹ️ This interface belongs to the AceDataCloud Platform Management API, with a unified prefix of https://platform.acedata.cloud/api/v1/.

Interface Overview

Item Content
Method GET
URL https://platform.acedata.cloud/api/v1/apis/{api_id}/usage/
Authentication ❌ Public

Authentication Description

This interface is completely public, no account token or login state is required.

Path Parameters

Parameter Type Required Description
api_id UUID ✅ API ID (UUID format)

Request Example

cURL

curl 'https://platform.acedata.cloud/api/v1/apis/afc7917f-d89f-4dc9-95c2-863936b02cad/usage/' \
  -H 'accept: application/json'

Python

import requests

api_id = "afc7917f-d89f-4dc9-95c2-863936b02cad"
resp = requests.get(
    f"https://platform.acedata.cloud/api/v1/apis/{api_id}/usage/",
    headers={"accept": "application/json"},
    timeout=10,
)
items = resp.json()
if not items:
    print("No recent calls for this API")
else:
    total = sum(it["count"] for it in items)
    success = sum(it["count"] for it in items if 200 <= it["status_code"] < 300)
    print(f"Total calls: {total:,}")
    print(f"Success rate: {success / total:.1%}" if total else "")
    for it in items:
        print(f"  HTTP {it['status_code']:>3}: {it['count']:>8,}")

Node.js

const apiId = 'afc7917f-d89f-4dc9-95c2-863936b02cad'
const r = await fetch(`https://platform.acedata.cloud/api/v1/apis/${apiId}/usage/`)
const items = await r.json()
items.forEach((it) => console.log(`HTTP ${it.status_code}: ${it.count}`))

Response Example (HTTP 200)

When there are no call records:

[]

When there are calls:

[
  { "status_code": 200, "count": 12453 },
  { "status_code": 401, "count": 87 },
  { "status_code": 422, "count": 12 },
  { "status_code": 500, "count": 3 }
]

ℹ️ Note that this interface does not return paginated responses — it directly returns an array, without a count/items wrapper.

Response Field Description

Each record:

Field Type Description
status_code integer HTTP status code
count integer The number of occurrences of this status code recently (usually a rolling window of the past 7 days)

⚠️ The specific time window is controlled by the server and is not guaranteed. Do not use it as a stable API for billing or SLA reporting; it is only suitable for a "health overview."

Error Handling

HTTP Code Meaning
400 invalid api_id is not a valid UUID
404 not_found API does not exist

Practical Tips

  • To view your own call records, use Get AceDataCloud Platform API Call Records (with the ?user_id= parameter). This interface looks at the cumulative calls for the entire platform.
  • To create a status page: Poll this interface every minute to calculate the 2xx / 5xx ratio, which can roughly reflect the health status of the API. However, it is not true real-time monitoring and should only be used as a reference.
  • Status codes with count=0 will not be returned — so if the array only contains 200, it means that the API has not had any 4xx/5xx failures recently.