> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aibase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cURL 调用

> 使用 cURL 从环境变量读取 API Key，并调用 AIBase 开放平台统一任务接口。

下面的命令可以直接调用当前已上线的“AI 对话问题挖掘”服务。先将 API Key 写入当前终端会话的环境变量。

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    export AIBASE_API_KEY="AIBase_xxxxxxxxxxxxxxxx"

    curl --request POST \
      --url https://api.aibase.cn/v1/openapi/tasks \
      --header "AIBase-API-Key: ${AIBASE_API_KEY}" \
      --header "AIBase-Request-Id: req-$(date +%s)" \
      --header 'Content-Type: application/json' \
      --data '{
        "apiCode": "geo.questions_corr_recommend",
        "data": {
          "keyword": "多智能体系统"
        }
      }'
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    $env:AIBASE_API_KEY = "AIBase_xxxxxxxxxxxxxxxx"

    curl.exe --request POST `
      --url "https://api.aibase.cn/v1/openapi/tasks" `
      --header "AIBase-API-Key: $env:AIBASE_API_KEY" `
      --header "AIBase-Request-Id: $([guid]::NewGuid())" `
      --header "Content-Type: application/json" `
      --data-raw '{
        "apiCode": "geo.questions_corr_recommend",
        "data": {
          "keyword": "多智能体系统"
        }
      }'
    ```
  </Tab>
</Tabs>

<Warning>
  生产环境不要把真实 API Key 写入脚本或提交到代码仓库。Windows PowerShell 中请调用 `curl.exe`，避免旧版本环境把 `curl` 解析为其他命令别名。
</Warning>

## 判断是否成功

1. 检查 HTTP 状态是否符合预期。
2. 解析 JSON 并确认业务 `code = 200`。
3. 从 `data.result` 读取两组问题数组。
4. 保存 `data.requestId`，用于日志关联和问题排查。

<Columns cols={2}>
  <Card title="查看完整接口定义" icon="messages-square" href="/api-reference/question-discovery">
    核对请求参数、响应字段和数据类型。
  </Card>

  <Card title="调用失败" icon="list-checks" href="/platform/troubleshooting">
    按联调清单逐项定位问题。
  </Card>
</Columns>