Skip to main content
GET
发布者用量分析

端点

认证:需要 API Key(Authorization: Bearer <API Key>)。 我的 App 在一段时间内被怎样调用:区间合计,加按日(或短区间按小时)、按 App、按调用渠道拆分(可两两交叉),或为诊断而按终态、按版本、按错误码拆分。它是账单聚合在发布者侧的对应物:词汇相同(created_from / created_to 按运行发起时间,起点包含、终点不包含;tz_offset 只移动日边界;data_app / triggered_by 缩小范围),归属从「我发起的运行」翻转为「我拥有的 App」(含零 Release 的 App)。 日 / 小时 / App / 渠道拆分来自终态时累加的小时桶,任意区间与整小时偏移都精确且廉价。状态 / 版本 / 错误码拆分按需从运行明细计算,因此必须给出两端且跨度不超过 92 天(400 range-too-wide);错误分组只覆盖带错误的运行,每组附最近一条错误消息 sample_message。作者调试运行默认排除,平台巡检永不计入。成功计入部分成功,取消不进成功率分母,没有终态运行的指标为 null。amount 是调用方为这些运行支付的数据费,不是发布者的结算收益。 日 / 小时分组升序(hour 键是 tz_offset 下的本地时钟 YYYY-MM-DDTHH:00,不带时区后缀),其他分组按运行数降序。data_app 里未知或他人的 App 为 404。 totals.callers 是区间内的不同调用用户数,来自运行明细,只在区间有界且不超过 92 天时有值。group_by=caller 把单个私有或分享 App 按调用方拆分:作者自己(caller_kind=owner)和当前名单内的用户(grantee)按当前用户名显示,其他人(曾被授权者、公开时期的调用者)合并为一个 other 组。公开 App 或多个 App 为 400 caller-group-unavailable:公开 App 的调用方匿名,只计数。

请求

查询参数

string
默认值:"day"
一到两个维度,逗号分隔,取值 day / hour / data_app / triggered_by / state / version / error / caller(如 day,data_app)。day 与 hour 不能组合;state / version / error / caller 需要不超过 92 天的有界区间;caller 还需要恰好一个私有或分享 App。默认 day。
string[]
只看这些 App(<username>/<app_name>,可重复传),默认全部我的 App。
string
起点,包含。
string
终点,不包含。
integer
默认值:"0"
日 / 小时分桶的时区偏移,分钟,北京时间传 480。桶是小时级,半小时偏移会近似到整点。范围 -720 到 840。
string
只看一个调用渠道(api / sdk / mcp / web 等)。
boolean
默认值:"False"
是否并入作者调试运行。
boolean
默认值:"False"
同时返回紧邻 created_from 之前等长区间的 previous_totals,需要两端都给。

示例请求

响应

200 成功

响应包在 data 字段中,其内容如下。
object
必填
本次实际使用的区间与偏移。
string
币种。
object
必填
区间合计。
object
compare=true 时的上一等长区间合计。
string
本次实际使用的维度。
object[]
分组列表,每组带与 totals 相同的指标,外加本维度的键(day / hour / namespace + app_name / channel / state / version / error_code + error_category + sample_message + last_seen_at / username + caller_kind),未用到的键为 null。

错误

错误响应统一为 {"error": {code, category, message, retryable}},见错误。

客户端库

Python 与 JavaScript SDK 暂未封装此端点,请直接调用 REST。