积分流水列表
分页查询当前商户下的积分消耗流水,支持按用户、应用、类型、时间范围筛选。数据范围自动限定为当前商户,无需传入 tenantId。
分页查询当前商户下的积分消耗流水,支持按用户、应用、类型、时间范围筛选。数据范围自动限定为当前商户,无需传入 tenantId。
POST /openapi/v1/usage/transactions/list
支持 App-Secret(X-App-Id + X-App-Secret)或 Console JWT 鉴权,商户可通过 API 集成到自己的系统。不同于 /credit/transactions/list,此接口包含用户昵称等冗余信息,适合直接展示。
请求参数
参数
类型
请求示例
{
"page": 1,
"pageSize": 20,
"startTime": "2024-06-01 00:00:00",
"endTime": "2024-06-07 23:59:59"
}响应示例
{
"code": 0,
"msg": "ok",
"data": {
"list": [
{
"id": 101,
"tenant_id": 1,
"user_id": 10001,
"username": "小明",
"amount": -10,
"balance_after": 990,
"type": "conversation",
"ref_type": "agent",
"ref_id": 42,
"session_id": "sess_abc123",
"description": "对话消耗 (agentId=42)",
"created_at": "2024-06-01 12:00:00"
}
],
"total": 1,
"page": 1,
"pageSize": 20
}
}