> ## 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.

# 实时请求模式

> GEOBase 开发者 API 全部为 SYNC 实时请求，一次调用直接返回业务结果。

GEOBase 开发者 API 所有业务接口均为 **SYNC · 实时请求**：请求发出后，服务端同步执行业务并直接在当前响应中返回结果，不存在异步任务，无需轮询、无需二次查询。

<CardGroup cols={3}>
  <Card title="一次请求" icon="send">
    提交即执行，无需提交后再查询任务状态。
  </Card>

  <Card title="直接返回" icon="check-check">
    响应体 `data` 即业务结果，无 `taskId` 等中间态。
  </Card>

  <Card title="合理超时" icon="timer">
    实时接口耗时随业务量变化，建议设置合理的客户端超时时间，例如 60 秒。
  </Card>
</CardGroup>

## 与 AIBase 开发者 API 的差异

<Tip>
  AIBase 开发者 API（入口 `/v1/openapi/tasks`）同时提供同步与异步两种模式，异步接口需要先提交任务拿到 `taskId`，再每隔 10 秒轮询查询结果。GEOBase 开发者 API（入口 `/v1/openapi/execute`）**没有任务态**，请勿把轮询逻辑套用到本套接口上。
</Tip>

## 客户端建议

1. **设置超时**：实时接口耗时随业务量变化，建议客户端超时不小于 60 秒，并区分「连接超时」与「读取超时」。
2. **不要轮询**：响应即为最终结果，重复调用只会重复执行一次业务逻辑。
3. **保留现场**：发生超时或异常时，保留 `AIBase-Request-Id`、`apiCode`、请求参数与响应时间，便于排查。

<Card title="继续：解析响应与错误码" icon="arrow-right" href="/geobase-api/quickstart/response-errors" horizontal>
  了解统一响应结构与 2001 / 4001 / 4002 / 403 / 4021 / 500 的处理分支。
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.