首页 > 开放平台 > 公共异常码
开放平台/公共异常码

公共异常码

航税云开放平台公共异常码对照表:涵盖签名、鉴权、解密、流量、参数等常见异常,附处理建议。

公共异常码对照表

开放平台会对开发者的接口非业务调用错误做统一处理,返回码如下。接入过程中如遇异常,可按表内建议排查。

异常代码描述处理建议
0200API 签名异常服务异常,请联系开放平台管理员
0201必填项输入参数空请确认必填字段是否不为空
输入参数格式有误请确认数据格式是否填写正确
API 授权异常服务异常,请联系开放平台管理员
客户端传输格式与解析格式描述不相符请确认消息头 dataType 指定数据格式是否与请求数据格式匹配
0202API 计费异常服务异常,请联系开放平台管理员
0203API 处理异常服务异常,请联系开放平台管理员
040102API 服务异常,请稍后重试服务异常,请联系开放平台管理员
05请求编码异常URLDecoder 解码异常
0701解密异常请检查 appKey 是否填写正确
070101密钥空请检查 appKey 是否填写正确
获取 app 密钥失败或 appKey 无效请检查 appKey 是否填写正确
070102密钥长度不够请确认 appSecret 填写正确
070103无法识别加密算法请确认消息头 signMethod 值是否正确,目前仅支持 AES
070201超出 API 日流量限额API 当日免费调用次数超出限制,请联系开放平台运营增加调用次数(免费 API)
070204当前接口无剩余流量,请前往应用概况页面增加接口调用量API 剩余调用次数已用完,请自行在平台上购买(收费 API)
070301accessToken 不匹配 / 或 appKey 不匹配请检查 accessToken、appKey 是否填写正确及匹配
070302APP 未申请该资源请联系开放平台运营开通 API 权限
请联系服务商开通 API 权限请联系服务商开通 API 权限
请联系服务商调整 API 使用期限请联系服务商调整 API 使用期限
请联系服务商调整 API 日流量限额请联系服务商调整 API 日流量限额
0704解压异常请确认是否使用 GZIP 压缩及压缩、数据加密和 URL 编码顺序是否正确
压缩方式无法识别请确认消息头 compress 字段是否填写正确,目前仅支持 GZIP
070401调用用户身份不匹配请检查商户税号 taxnum 和 token 是否匹配
070501请求的 API 不存在请检查 API 编码是否填写正确,再次重试
070601密钥获取失败请检查 appKey 是否填写正确
签名不匹配请使用官方 SDK 调用 API,尽量保证服务器编码为 UTF-8;如果是 Windows 服务器默认编码为 GBK,可通过 SDK 中的 convertToUtf8 方法转换报文体,如 body = sdk.convertToUtf8(body);
验签失败请检查服务器时间是否与北京时间保持一致
提示:以上为接口调用公共异常码。业务层面的具体返回码请以各接口文档中的说明为准。

申请试用

请留下您的联系方式,我们将在一个工作日内与您联系