交通标准知识库 API

traffic-standards-kb Skill 使用的标准检索接口，用于查询中国交通运输行业标准（GB、JT/T、GA/T 等）。

请求地址

POST https://solvexpert.net/api/v1/standards/query

认证方式

请求需要同时提供两种认证：

1. 请求头： X-API-Key: $STANDARDS_API_KEY
2. 请求体参数： searchAuthToken: "Thn5ItDQS9aEa3cay-855l2woSmW2Z4U"（必须）

缺少 searchAuthToken 会导致 "Authentication error: API key is invalid!" 错误，即使 API Key 有效。

请求参数

参数	类型	必填	说明	默认值
question	string	是	自然语言查询	-
searchAuthToken	string	是	SearchBots 认证令牌	Thn5ItDQS9aEa3cay-855l2woSmW2Z4U
domains	string[]	否	领域过滤，不填则自动检测	自动检测
depth	string	否	检索深度：basic/medium/full	medium
searchId	string	否	搜索应用 ID	4d68cee6226611f19327c66d7f7cba76
pageSize	int	否	每页结果数（1-100）	根据 depth 自动映射
similarityThreshold	double	否	相似度阈值（0.0-1.0）	0.5

检索深度说明

depth	pageSize	返回内容
basic	5	标准号 + 标题 + 执行单位 + 适用范围
medium	10	basic + 归口单位 + 发布/实施日期 + 关键条款
full	30	medium + 完整元数据 + AI 要点总结 + 条文索引

有效领域值

• 信号控制
• 停车系统
• 交通监控
• 数据采集
• 收费系统
• 公共交通
• 车路协同
• 出行服务
• 交通管理
• 新兴领域

请求示例

curl -s -X POST "https://solvexpert.net/api/v1/standards/query" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $STANDARDS_API_KEY" \
  -d '{
    "question": "智慧高速及智慧服务区相关的标准",
    "domains": ["新兴领域"],
    "depth": "medium",
    "searchId": "4d68cee6226611f19327c66d7f7cba76",
    "searchAuthToken": "Thn5ItDQS9aEa3cay-855l2woSmW2Z4U"
  }' | python3 -m json.tool

响应格式

{
  "code": 0,
  "message": "Success",
  "data": {
    "standards": [
      {
        "standardNumber": "GB 14886-2016",
        "title": "道路交通信号灯设置与安装规范",
        "similarity": 0.92,
        "content": "..."
      }
    ],
    "total": 10
  }
}

不同 depth 级别返回的字段不同。basic 返回标准号、标题、执行单位、适用范围；medium 额外返回归口单位、发布/实施日期、关键条款（keyPoints）；full 返回所有元数据字段。

常见错误

错误	原因	解决方案
401 Unauthorized	缺少或无效的 API Key	检查 X-API-Key 请求头是否正确设置
"Authentication error: API key is invalid!"	缺少 searchAuthToken	确保请求体中包含 searchAuthToken 参数
504 Gateway Timeout	请求超时	降低 depth 参数或等待后重试
空的标准数组	知识库中无匹配文档	调整查询关键词或领域
400 Bad Request	参数值无效	检查 depth 和 pageSize 参数范围

关联 Skill

本 API 为 交通标准知识库skill 的后端服务接口。安装该 Skill 后，Agent 将自动调用本接口检索标准文献，并以规范格式引用到方案文档中。详见 Skill 文档了解安装说明、适用场景和最佳实践。