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

一次请求

提交即执行，无需提交后再查询任务状态。

直接返回

响应体 data 即业务结果，无 taskId 等中间态。

合理超时

实时接口耗时随业务量变化，建议设置合理的客户端超时时间，例如 60 秒。

​
与 AIBase 开发者 API 的差异

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

​
客户端建议

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

继续：解析响应与错误码

了解统一响应结构与 2001 / 4001 / 4002 / 403 / 4021 / 500 的处理分支。