免费注册
开发者文档

API 开发文档

快速接入GEO天眼API，轻松实现多平台AI数据采集

概述

GEO天眼提供RESTful API，支持通过API密钥进行身份认证。所有请求需使用HMAC-SHA256签名，确保通信安全。

Base URL：https://api.geotianyan.com/v1

认证方式

API使用密钥对进行身份认证，您需要在控制台生成 api_key 和 api_secret。

签名算法

  1. 将请求参数按字母排序，拼接为查询字符串
  2. 计算请求体的SHA256哈希值
  3. 使用 api_secret 对拼接字符串进行HMAC-SHA256签名
  4. 将签名放入请求头 X-Signature
签名示例
signature = HMAC-SHA256(api_secret, string_to_sign)
string_to_sign = method + "\n" + path + "\n" + timestamp + "\n" + body_hash

API端点

POST/tasks/submit提交采集任务
POST/tasks/batch批量提交任务（文件上传）
GET/tasks查询任务列表
GET/tasks/{id}查询任务详情

错误码

错误码说明处理建议
40001签名验证失败检查 api_secret 和签名算法
40002时间戳过期确保请求时间在5分钟内
40003Nonce重复每次请求使用唯一nonce值
40301余额不足请先充值
42900请求频率超限等待 Retry-After 后重试

频率限制

为保障服务稳定性，API调用有以下频率限制：

  • 任务提交：60次/分钟
  • 任务查询：120次/分钟

超出限制将返回 429 Too Many Requests，请根据 Retry-After 头等待后重试。