Skip to main content
当请求失败或结果不符合预期时，请先记录发生时间、HTTP 状态、业务 code、apiCode 和 requestId，再按照本页顺序检查。
排错截图、终端输出和工单内容中不要包含完整 API Key。展示 Header 时请对密钥中间部分做脱敏处理。

​
一分钟预检

  • 请求方法为 POST。
  • 请求地址为 https://api.aibase.cn/v1/openapi/tasks。
  • AIBase-API-Key 位于请求 Header，而不是 Query 或请求体。
  • Content-Type 为 application/json。
  • apiCode 为 geo.questions_corr_recommend。
  • data.keyword 存在且不为空。
  • 请求体是合法 JSON，没有多余逗号或错误引号。

​
按现象定位

​
检查原始 HTTP 结果

联调时可以先将响应体保存到文件，并单独输出 HTTP 状态。以下命令不会打印请求 Header，可减少密钥出现在终端记录中的风险。
检查 aibase-response.json 时，依次确认：响应是合法 JSON、业务 code 为 200、data 不为空、需要的数组字段存在。

​
排错记录模板

持续失败时，整理以下信息可以减少重复沟通：
错误响应中的 data 可能为 null，因此不保证每次失败都能从 data.requestId 取得请求标识。此时请保留客户端传入的 AIBase-Request-Id 和准确请求时间。

响应与错误处理

查看状态码、恢复动作和解析顺序。

requestId 请求追踪

设计生产环境日志关联字段。