租户每日用量指标增量同步 - SyncDomainDailyIndicators

功能介绍

按复合游标 (domain_id, pk_id) 增量返回租户每日用量数据。通过start_date和end_date参数限定同步时间范围。

注意：仅企业管理员（enterprise_admin）可调用。

调用方法

请参见如何调用API。

URI

POST https://collector-agents-access.cn-north-4.myhuaweicloud.com/dataflywheel/datapreprocess/v1/sync/usage/domain-daily

请求参数

表1 请求Body参数
参数	是否必选	参数类型	描述
cursor	否	String	参数解释：增量游标。首次同步：不传或传空，从最小键开始。增量同步：传入上次响应的next_cursor。取值范围：不涉及约束限制：格式：domain_id\|pk_id，使用\|分隔。默认取值：不涉及
page_size	是	Integer	参数解释：每页条数取值范围： 1-500 约束限制：不涉及默认取值：不涉及
start_date	是	String	参数解释：起始时间取值范围：不涉及约束限制： yyyy-MM-dd，闭区间。默认取值：不涉及
end_date	是	String	参数解释：结束时间取值范围：不涉及约束限制： yyyy-MM-dd，闭区间，与start_date最大跨度60天。默认取值：不涉及

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
code	Integer	参数解释： HTTP状态码取值范围： 200：响应成功
data	SyncDomainDailyData object	参数解释：用量数据同步信息

表3 SyncDomainDailyData
参数	参数类型	描述
items	Array of SyncDomainDailyItem objects	参数解释：用量详情
next_cursor	String	参数解释：下一页游标取值范围：不涉及
has_more	Boolean	参数解释：是否还有更多数据取值范围： true: 还有更多数据 false: 已同步完成

表4 SyncDomainDailyItem
参数	参数类型	描述
team_id	String	参数解释：团队ID 取值范围：不涉及
team_name	String	参数解释：团队名称取值范围：不涉及
pk_id	String	参数解释：记录唯一键取值范围：不涉及
dt	String	参数解释：数据日期取值范围：不涉及
model_id	String	参数解释：模型ID 取值范围：不涉及
model_name	String	参数解释：模型名称取值范围：不涉及
service_function	String	参数解释：功能模块名取值范围：不涉及
input_token_cnt	Long	参数解释：输入Token数取值范围： ≥0
output_token_cnt	Long	参数解释：输出Token数取值范围： ≥0
total_token_cnt	Long	参数解释： Token总消耗取值范围： ≥0
total_credit_cnt	Double	参数解释：积分消耗取值范围： ≥0

请求示例

首次同步，示例如下：

POST https://collector-agents-access.cn-north-4.myhuaweicloud.com:443/dataflywheel/datapreprocess/v1/sync/usage/domain-daily

{
  "page_size" : 500,
  "start_date" : "2026-04-01",
  "end_date" : "2026-04-30"
}

增量同步（翻页），示例如下：

POST https://collector-agents-access.cn-north-4.myhuaweicloud.com:443/dataflywheel/datapreprocess/v1/sync/usage/domain-daily

{
  "cursor" : "domain-001|a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "page_size" : 500,
  "start_date" : "2026-04-01",
  "end_date" : "2026-04-30"
}

响应示例

状态码：200

同步成功（还有下一页），示例如下：

{
  "code" : 200,
  "data" : {
    "items" : [ {
      "team_id" : "team-001",
      "team_name" : "平台组",
      "pk_id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "dt" : "2026-04-01",
      "model_id" : "gpt-4",
      "model_name" : "gpt-4",
      "service_function" : "Agent",
      "input_token_cnt" : 234560,
      "output_token_cnt" : 333240,
      "total_token_cnt" : 567800,
      "total_credit_cnt" : 56.78
    } ],
    "next_cursor" : "domain-001|a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "has_more" : true
  }
}

同步完成（无更多数据），示例如下：

{
  "code" : 200,
  "data" : {
    "items" : [ ],
    "next_cursor" : null,
    "has_more" : false
  }
}

状态码：403

{
  "code" : 403,
  "status" : "DataFlywheel.00000403",
  "msg" : "Access denied"
}

状态码：429

{
  "code" : 429,
  "status" : "DataFlywheel.00000429",
  "msg" : "Too many sync requests, please try again later."
}

状态码：500

{
  "code" : 500,
  "status" : "DataFlywheel.00000500",
  "msg" : "Failed to sync usage indicators."
}

状态码

状态码	描述
200	OK
400	参数校验失败（page_size超界、start_date > end_date、时间跨度超过60天、游标格式错误、日期格式错误）
403	鉴权失败（token无效或越权查询）
429	请求频率超限（单位时间内请求过多）
500	服务端异常

错误码

请参见错误码。

父主题：用量数据增量同步接口

上一篇：成员每日用量指标增量同步 - SyncUserDailyIndicators

下一篇：附录