全新 API 凭据协议上线。支持 AES 双向加密传输。

API 响应状态码 status 说明

概述

当 API 结果响应状态标识 status 出现下述错误码值时,您应该根据错误码说明采取处理措施。

简易理解:

    if (results.status == 200) {
        //请求成功处理;
    } else if (results.status == 404) {
        //无记录数据时处理;
    } else {
        if (results.status == 702) {
            //API 订阅过期处理(需要继续订阅);
        } else {
            //请求错误处理;
        }        
    }

正常状态码

200 与 404 您可以当作正常的状态码。

status含义说明
200OK请求成功,返回到有效数据
404未收录此数据请求成功,但没有返回到对应数据;

错误状态码

除了上述正常状态码外,其它数字的状态码皆为错误状态码。

status含义说明
0未知错误
100站点或服务维护中待恢复后可访问
110参数或格式错误请检查传入参数:是否缺失、值格式、传值方式(某些参数只能 url 传递,或只能 post 传递)。
120参数校验错误请检查传入参数:值范围或可选值错误。
131凭据参数错误请检查传入参数:oid、key 参数。
132凭据不存在或未生效凭据 key 不存在; 或凭据 key 已创建但未发布生效,请发布凭据后重试;
133凭据未启用 API 服务请在【请求凭据 KEY】【设置】下,选择启用对应 API 服务。
134凭据状态未启用凭据状态未启用。
135凭据 Key 错误请检查传入的参数:Key。
136凭据验证失败
137凭据验证失败禁止访问的 UserAgent。
138凭据验证失败禁止访问的 IP。
139凭据验证失败不在凭据允许规则之内(IP, domain)。
141AES 加密模式选项错误请检查 aesmode 可支持的选项。
142AES 填充模式选项错误请检查 aespadding 可支持的选项。
143AES 加密内容传入错误没有成功获取到传入的加密内容。请检查传值方式。
144AES 加密内容解密错误解密时出错。请检查加密方式是否正确。
145AES 请求时间过期当传入了 UTC 时间截时,超过 2 分钟过期。
701订阅不存在请检查传入的 OID 是不是正确。
702订阅过期请在 API 控制台下继续订阅(订阅延期或订阅次数)后可正常使用。
703订阅项目组不匹配请检查传入的 OID 与 KEY 需属于同一个 API 项目。
704订阅服务不匹配OID 与当前请求服务不匹配。
705订阅请求超额第二天可成功请求,或继续订阅后可请求。
709订阅停用订阅 OID 状态未启用。
900拒绝请求
901频率超限/当天请24小时后重试。
902频率超限/小时请1小时后重试。
903频率超限/分钟请1分钟后重试。
904超限黑名单请24小时后重试。
905黑名单 JSONP请24小时后重试。
906黑名单 JSONP请24小时后重试。

内部错误状态码

以下为内部产品使用。

status含义说明
500未登录
501账号错误
502密码错误
503登录错误次数超过限制
504请重新登录
505交易密码错误
509账户已锁定

相关链接