跳转到主要内容

HTTP 状态码

响应信封

成功

不支持的市场

当代币在任何支持的 DEX 上没有可用路由时返回。message 字段提供人类和 AI 可读的说明。

未索引

当代币存在但尚未解析时返回。短暂延迟后重试。

错误

验证失败、速率限制和服务器错误的通用错误响应。
SDK 解析所有响应变体,并通过 ExitApiError 类型呈现。

ExitApiError 类型

每个 SDK 都暴露一个带有 kind 判别器的 ExitApiError(或等效类型):

检查可重试性

内置重试行为

所有 SDK 包含自动重试,默认值如下: 重试仅在 isRetryable() 返回 true 时触发(传输故障、5xx 响应和 429 速率限制)。

自定义重试策略

最佳实践

  • 不要重试 400、401 或 422 错误。这些表示必须在代码中修复的请求或认证问题。
  • 不要重试 404 且 "status": "unsupported" 的响应。该代币没有支持的市场。
  • 重试一次 404 且 "status": "not_indexed" 的响应。代币可能需要一点时间来解析。
  • 指数退避 429 响应。内置重试自动处理。
  • 带退避重试 502 和 503 错误。这些是暂时的基础设施问题。
  • 记录错误详情,包括 kind、status 和 body 以便调试。
  • 如果持续看到 envelope_status 错误,验证你的 mint 地址和 user_pubkey 是否正确。