Skip to main content
GET
日志查询
分页查询当前凭证所属范围内的调用、消费、充值、管理、错误、退款和测试金日志。

接口信息

  • HTTP 方法GET
  • 请求地址https://maas.gravitex.ai/prod-api/api/logs/v2/page
  • 鉴权请求头Authorization
  • 语言请求头Accept-Language,支持 zh-CNen-US
  • 时间格式yyyy-MM-dd HH:mm:ss
  • 时间范围上限:31 天
  • 默认分页page=1pageSize=30
  • 每页数量上限:1000

用户鉴权

以下格式均支持:
不要在 URL、前端代码、日志或工单中明文记录完整 Key。

查询参数

integer
默认值:"1"
页码;小于或等于 0 时按 1 处理
integer
默认值:"30"
每页数量;小于或等于 0 时按 30 处理,最大 1000
string
APIkey名称, 鉴权方式为系统访问令牌时模糊查询; 为APIkey时不可用,强制查询当前APIkey的日志
string
模型名称,精确匹配;多个模型用英文逗号分隔
string
请求 ID,精确匹配
string
请求 IP,精确匹配
integer
最小用时,单位秒,包含边界
integer
最大用时,单位秒,包含边界
string
开始时间,格式 yyyy-MM-dd HH:mm:ss,包含边界
string
结束时间,格式 yyyy-MM-dd HH:mm:ss,包含边界
string
日志类型,多个值用英文逗号分隔;允许值为 1,2,3,5,6,8

日志类型

Accept-Language

只影响 billingProcessText

请求示例

响应结构

金额字段 quotaDollar 使用十进制字符串返回,调用方应使用 Decimal/BigDecimal 处理,不建议转换为二进制浮点数。

响应字段

失败响应

调用建议

  1. 服务端安全保存访问令牌或 API Key,不要把完整 Key 写入日志。
  2. 推荐传入不超过 31 天的时间范围。
  3. 翻页时读取 data.total,但不要把它当作页数。
  4. 检查响应体 code,不要只依据 HTTP 200 判断业务成功。
  5. 金额使用 Decimal/BigDecimal 处理,不要用二进制浮点数重新计算。