# 错误码说明
### 一、错误码简介
1. API调用可能会返回两种错误码,分别为通用错误码、业务错误码,具体如下。
* 通用错误码:例如通用参数验证错误,情况有参数为空、access_token有误等。
* 业务错误码:每个接口特有的业务错误码,通过错误码可以得到接口业务异常信息。
### 二、通用错误码
|通用错误码|错误说明|
|-|-|
|3002|通用请求参数错误,必填参数不存在或者为空,可选参数为空,验证错误
|3003|通用请求参数错误,access_token有误
### 三、业务错误码
|业务错误码|错误说明|
|-|-|
|6001|通用设备异常错误,如离线、未绑定
|6002|通用设备权限异常错误
|5001|打印订单通用错误
|4001|通用快递鸟请求参数错误 必填参数不存在或者为空,可选参数为空
|4002|通用快递鸟验证参数错误
|999|通用服务器内部错误,这种情况请联系管理员、技术处理
|9999|通用未知错误,这种情况请联系管理员、技术处理
### 四、错误码示例
```json
{
"error": 3002,
"error_description": "client_id 不能为空",
"timestamp": 1686127108,
"body": []
}
```
```json
{
"error": 3002,
"error_description": "client_id 长度必须是 10",
"timestamp": 1686127128,
"body": []
}
```
```json
{
"error": 3002,
"error_description": "client_id 不存在或已注销",
"timestamp": 1686127157,
"body": []
}
```
#### 示例说明
|名称|类型|空|描述
|-|-|-|-|
|error|int|否|错误码
|error_description|string|否|错误描述
|timestamp|int|否|时间戳(秒)
|body|json|是|请求成功会返回相应数据,失败则无返回
- 使用前准备【必看】
- 开发者服务指引【必看】
- 接口更新动态
- 2024年5月
- 2024年1月
- 2023年11月
- 2023年10月
- 2023年9月
- 2023年6月
- 开发文档【必看】
- 调用协议【必看】
- 授权文档【必接】
- 自有型应用
- 开放型应用(OAuth2.0授权码模式)
- 开放型应用(扫码授权模式)
- SDK使用说明
- API文档【按需对接】
- 设备文档
- 设备绑定
- 设备解绑或取消授权
- 状态获取
- 离线或重启控制
- 打印控制
- logo控制
- 音效音量控制
- 内置语音控制
- 打印宽度获取
- 型号版本获取
- 接单拒单控制
- 打印文档
- 文本打印
- 图片打印
- 面单文档
- 面单生成并打印
- 面单取消
- 打印队列文档
- 订单状态获取(单订单)
- 订单列表获取
- 订单取消打印(单订单)
- 订单取消打印(全量)
- 订单重打(单订单)
- 应用设置文档
- 推送地址设置
- K8支付设置文档
- 推送开关设置
- 关键词设置
- 高级设置
- 打印消息推送
- 打印消息推送说明
- 打印完成推送
- 终端状态推送
- 接单拒单推送
- K8扫码信息推送
- 扫码相关功能流程图
- 产品介绍
- 授权说明
- 消息推送
- http/https推送方式
- 签名验证规则
- 解密规则
- 指令说明
- 验签解密示例
- 打印指令文档
- 指令文档说明
- 文本打印指令集
- 语音指令文档
- 多语言指令文档
- 扫码功能指令
- 常见问题
- 错误码说明
- FAQ