小影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 聚合服務