跳转到主要内容
开始创作
开发文档

积分流水列表

分页查询当前商户下的积分消耗流水,支持按用户、应用、类型、时间范围筛选。数据范围自动限定为当前商户,无需传入 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
  }
}