小影API 小影API

调用统计

公开查询 API 调用量：某个接口被调用了多少次、各服务调用量排行。仅公开调用次数，不含项目与耗时。

/api/statistics/

服务说明

调用统计服务对外公开每个接口的调用量：可以查某个接口被调用了多少次（累计与今日），也可以查各服务的调用量排行，适合做公开的运营数据展示，或写入自己的监控面板。

这是本站唯一无需签名的开放服务，未登录也能直接调用。统计口径只包含调用次数，不包含调用方项目、失败率与耗时等敏感信息。

数据按天预聚合，写入最多延迟数秒，因此刚发生的调用可能不会立刻体现在结果里。

响应格式

所有接口返回同一个 JSON 信封，业务数据都在 data 里： 

{
  "code": 10000,
  "msg": "成功",
  "data": { ... }
}
  • code：业务状态码，10000 表示成功；其余为各类错误，完整清单见「错误码」页。
  • msg：给人看的提示文案，可直接展示给终端用户，但不要用它做逻辑判断。
  • data：业务数据；出错时通常为 null。各接口 data 的具体字段见该接口的「响应说明」。

判断成功与否请看 code，不要依赖 HTTP 状态码。 查看完整错误码

维护中 该服务当前处于「维护中」状态，接口可能临时不可用。以下文档与调试仅供了解。

调用量查询

小影API 内置调用统计（按天预聚合） 开放 · 免签名

调用量为公开信息，接口开放（免签名）。数据按天聚合，写入最多延迟数秒；统计范围仅 /api/ 业务接口，认证被拒与未匹配路由同样计入。

GET /api/statistics/api_calls 累计调用 0 次

查询单个接口调用量

返回某个接口的累计调用次数与今日调用次数。

必填：文档中心已登记的接口路径；带路径参数的接口按文档写法传占位符，如 /api/music/xiaoying/musics/<uuid>

  • 公开接口，无需项目签名。
  • path 未登记时返回 code=20003；未传时返回 code=20001。
响应说明 外层统一格式
字段 类型 说明
path string 查询的接口路径
total_calls int 累计调用次数
today_calls int 今日调用次数
返回示例 
{
  "path": "/api/email/v1/send",
  "total_calls": 12345,
  "today_calls": 67
}
GET /api/statistics/services 累计调用 0 次

各服务调用量排行

返回各服务的累计与今日调用次数，按累计调用量降序。

  • 公开接口，无需项目签名。
响应说明 外层统一格式
字段 类型 说明
services array 各服务调用量列表（按累计降序）
services[].service string 服务前缀（如 /api/email/）
services[].name string 服务名称
services[].total_calls int 累计调用次数
services[].today_calls int 今日调用次数
返回示例 
{
  "services": [
    {"service": "/api/email/", "name": "邮箱服务", "total_calls": 12345, "today_calls": 67}
  ]
}
小影API · 通用 API 聚合服务