Genesis API 文档

接入所需的一切:认证、限额、接口和响应结构。

文档错误

错误

出错时返回相应的 HTTP 状态码及响应体:

json
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Requests per second limit exceeded."
  }
}
HTTP代码说明
400bad_request请求参数无效——详情见 message
401invalid_key密钥缺失、无效或已被吊销,或 API 订阅已过期
403plan_restricted你的套餐不包含该接口
404not_found未找到接口或资源
410gone该接口已停用——替代接口见 message
429rate_limited超出限流——请查看 X-RateLimit 和 Retry-After
429download_limited超出下载量限制:每个密钥每 10 秒 60 MB 压缩数据,参见 Retry-After
500internal_error内部错误,请稍后重试
503snapshot_not_ready数据正在重建或其数据源正在重启——请几秒后重试,见 Retry-After

每个响应都带有 X-Request-Id 请求头。联系支持时,请连同请求的 UTC 时间、接口和状态码一起发送——切勿发送你的密钥。