Tencent eSign 开放平台账单相关接口，用于查询应用维度下的消耗明细（子客消耗）。

认证

所有接口须在 Header 中携带：

Authorization: Bearer <access_token>

access_token 由 OAuth 2.0 认证中心通过 client_id + client_secret 换取，详见认证文档。

Scope 要求

账单相关接口需要授权 scope 中包含 bill:manage，否则会返回 HTTP 403 + insufficient_scope。

扣费空间维度

每个应用（client_id）绑定一个 OwnerSpaceId（即扣费空间）。账单接口的查询范围由服务端根据当前应用自动强制注入 OwnerSpaceId，调用方无需（也不允许）传入该字段，只能通过 SpaceId 参数进一步筛选某个子客空间。

时间格式

账单查询的时间参数 StartTime / EndTime 使用 RFC3339 格式（必须包含时区偏移，推荐使用 UTC 时间），例如 2026-06-01T00:00:00Z；跨度不得超过 31 天。响应中 OccurredAt 统一为 UTC 时区 的 RFC3339 字符串（Z 结尾），例如 2026-06-01T02:23:45Z。

响应结构

所有业务接口 HTTP 状态码统一返回 200，通过 Response.Error.Code 区分成功与失败：

{
  "Response": {
    "RequestId": "abc123",
    "Error": { "Code": "INVALID_REQUEST", "Message": "invalid time range" },
    "Data": { ... }
  }
}

成功时 Error 为空，Data 包含业务数据；错误时 Data 为空，Error 包含错误信息。

错误码