stats/detail - 详细统计 免费

详细统计接口返回每次工具执行的完整记录，包括请求参数、响应数据、执行耗时、计费详情等信息。适用于问题排查和审计追踪。

接口地址

POST https://api.jisuapi.com/agent/stats/detail

请求参数

请求头

响应格式

成功响应（status: 0）

{
  "status": 0,
  "msg": "ok",
  "result": {
    "total": 1250,
    "page": 1,
    "page_size": 20,
    "records": [
      {
        "execution_id": "exe_20260603_120102_xxx",
        "tool_id": "shouji_query",
        "tool_name": "手机号码归属地查询",
        "request": {
          "params": {"mobile": "13800138000"},
          "search_id": "sch_20260603_120001_xxx"
        },
        "response": {
          "status": 0,
          "data": {
            "province": "北京",
            "city": "北京",
            "company": "中国移动"
          }
        },
        "charge": {
          "layer": "free",
          "cost": 0.0,
          "credits_cost": 0
        },
        "timing": {
          "started_at": "2026-06-03T12:01:02.345Z",
          "completed_at": "2026-06-03T12:01:02.483Z",
          "elapsed_ms": 138,
          "upstream_ms": 120
        },
        "status": "success"
      }
    ]
  },
  "request_id": "req_..."
}

错误码

请求示例

查询今日记录

curl -X POST "https://api.jisuapi.com/agent/stats/detail" \
  -H "Authorization: Bearer 你的APPKEY" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "page_size": 20
  }'

查询指定执行记录

curl -X POST "https://api.jisuapi.com/agent/stats/detail" \
  -H "Authorization: Bearer 你的APPKEY" \
  -H "Content-Type: application/json" \
  -d '{
    "execution_id": "exe_20260603_120102_xxx"
  }'

查询失败记录

curl -X POST "https://api.jisuapi.com/agent/stats/detail" \
  -H "Authorization: Bearer 你的APPKEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "failed",
    "start_date": "2026-06-01",
    "end_date": "2026-06-03"
  }'

Python 示例

import requests

url = "https://api.jisuapi.com/agent/stats/detail"
headers = {
    "Authorization": "Bearer 你的APPKEY",
    "Content-Type": "application/json"
}

# 查询最近失败的执行记录
data = {
    "status": "failed",
    "page": 1,
    "page_size": 10
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

if result["status"] == 0:
    records = result["result"]["records"]
    print(f"找到 {result['result']['total']} 条失败记录\n")

    for record in records:
        print(f"执行ID: {record['execution_id']}")
        print(f"工具: {record['tool_name']}")
        print(f"时间: {record['timing']['started_at']}")
        print(f"错误: {record['response'].get('msg', '未知错误')}")
        print("-" * 50)
else:
    print(f"查询失败: {result['msg']}")

响应字段说明

record 对象

使用场景

• 问题排查：查看失败调用的具体错误信息和请求参数
• 性能优化：分析执行耗时，识别慢查询
• 审计追踪：记录所有 API 调用历史，满足合规要求
• 费用核对：详细查看每次调用的计费情况
• 调试测试：验证接口参数和返回数据

最佳实践

• 保存 execution_id：执行接口返回的 execution_id 可用于快速定位具体记录
• 定期检查失败记录：及时发现和修复问题
• 分页查询：数据量大时使用分页避免响应超时
• 时间范围控制：单次查询不超过 30 天，提高查询效率
• 导出数据：定期导出执行记录用于长期存档

数据保留策略

执行记录保留 90 天。超过 90 天的记录将被自动清理，无法查询。如需长期保存，请定期导出数据。

常见问题

Q: 可以查询多久之前的记录？

A: 最多可查询 90 天内的记录。单次查询时间范围不超过 30 天。

Q: 执行记录包含敏感数据吗？

A: 包含完整的请求参数和响应数据。如果涉及敏感信息，请注意保护 APPKEY 和接口访问权限。

Q: 如何导出所有记录？

A: 使用分页参数循环查询所有页，将数据保存到本地文件或数据库。