Skip to main content
下面使用当前已上线的“AI 对话问题挖掘”服务完成第一次调用。该服务的 apiCode 为 geo.questions_corr_recommend。

1. 准备请求

所有开放 API 共用以下地址:
请求体包含 apiCode 和 data。当前接口只需要一个关键词。

2. 发送请求

先把 API Key 写入当前终端会话的环境变量,避免把真实密钥保存到脚本中。
上述 cURL 命令适用于 macOS、Linux、Git Bash 和 WSL。Windows PowerShell 的完整命令见 cURL 调用。

3. 判断结果

请求成功后,平台返回统一外层结构,具体问题列表位于 data.result。
首次调用完成后,请确认 HTTP 状态正常、业务 code = 200,并保存 data.requestId。
本教程以 SYNC 同步模式 的接口为例。若您调用的接口为 ASYNC 异步模式(如 GEO 排名、品牌得分等),提交接口将返回 taskId,需要通过轮询查询结果。详细逻辑请参考 同步与异步任务模式。

4. 首次调用验收

  • 返回体可以解析为 JSON。
  • HTTP 状态符合预期,并且业务 code 为 200。
  • data.result.aiQuestions 和 data.result.baiduQuestions 按数组读取。
  • 日志中保存了 data.requestId,且没有记录完整 API Key。

同步与异步模式

了解 SYNC/ASYNC 执行区别与轮询规范。

查看完整接口定义

查看全部业务接口参数与返回结构。

处理错误响应

区分参数、认证、权限、限流和平台错误。