向服务器发出请求时,服务器会通过发出 HTTP 状态码和错误码来响应用户的请求。请参考下表进一步了解 API 调用失败时返回的不同错误码和错误提示。
响应示例
通用
| 错误提示 | HTTP 状态码 | 错误码 |
|---|
| 操作成功 | 200 | 0 |
| body 不能为空 | 400 | 50000 |
| 服务暂时不可用,请稍后重试 | 503 | 50001 |
| 非法的 json 数据 | 400 | 50002 |
| 接口请求超时(不代表请求成功或者失败,请检查请求结果) | 400 | 50004 |
| 接口已下线或无法使用 | 410 | 50005 |
| 无效的 Content_Type,请使用 "application/json" 格式 | 400 | 50006 |
| 账户被封禁 | 200 | 50007 |
| 账户不存在 | 200 | 50008 |
| 账户因清算被暂停使用 | 200 | 50009 |
| 用户 ID 为空 | 200 | 50010 |
| 用户请求频率过快,超过该接口允许的限额 | 429 | 50011 |
| 账户状态无效 | 429 | 50012 |
| 当前系统繁忙,请稍后重试 | 200 | 50013 |
| 必填参数 {0} 不能为空 | 400 | 50014 |
| 参数 {0} 和 {1} 不能同时为空 | 400 | 50015 |
| 参数 {0} 和 {1} 不匹配 | 400 | 50016 |
| 参数 {0} 和 {1} 不能同时存在 | 200 | 50024 |
| 参数 {0} 传值个数超过最大限制 {1} | 200 | 50025 |
| 系统错误 | 500 | 50026 |
| 您没有该 API 接口的访问权限,需要升级您的账户付费等级 | 403 | 50030 |
| 参数 {%} 错误 | 400 | 50036 |
| 代币不存在 | 200 | 50037 |
| 该公链不支持 | 200 | 50038 |
| 该警报 ID 没有历史处理记录 | 200 | 50039 |
| 此区块高度无数据 | 200 | 50040 |
| 当前不支持该代币的历史余额查询 | 200 | 50041 |
| 该代币不支持风险扫描 | 200 | 50042 |
| 您的账户行为触发了风险控制,API 功能已冻结。 | 200 | 50043 |
| 数据不存在 | 400 | 50044 |
| 客户端操作错误 | 400 | 50045 |
| 根据法律法规,您所在的国家或地区无法使用 X Layer API 服务 | 400 | 50047 |
鉴权
| 错误提示 | HTTP 状态码 | 错误码 |
|---|
| Api 已被冻结,请联系客服处理 | 400 | 50100 |
| 请求时间戳过期 | 401 | 50102 |
| 请求头 "OK_ACCESS_KEY" 不能为空 | 401 | 50103 |
| 请求头 "OK_ACCESS_PASSPHRASE" 不能为空 | 401 | 50104 |
| 请求头 "OK_ACCESS_PASSPHRASE" 错误 | 401 | 50105 |
| 请求头 "OK_ACCESS_SIGN" 不能为空 | 401 | 50106 |
| 请求头 "OK_ACCESS_TIMESTAMP" 不能为空 | 401 | 50107 |
| 无效的 IP | 401 | 50110 |
| 无效的 OK_ACCESS_KEY | 401 | 50111 |
| 无效的 OK_ACCESS_TIMESTAMP | 401 | 50112 |
| 无效的签名 | 401 | 50113 |
| 无效的授权 | 401 | 50114 |
| 无效的请求类型 | 405 | 50115 |
| 超过了历史数据查询的范围 | 400 | 50117 |
业务
| 错误提示 | HTTP 状态码 | 错误码 |
|---|
| {0} 参数错误 | 404 | 51000 |
| 您填写的 outputAddress 地址在该交易中没有找到。 | 200 | 51001 |
| 这个索引所指定的 outputAddress 在这个交易中不存在。 | 200 | 51002 |
| 该笔交易 Hash 在区块链上未解析到交易信息,无法确定该笔交易风险详情。 | 200 | 51003 |