电子面单重复打印
一、复打接口
该接口支持在提交打印请求2天内的打印任务进行复打10次的操作。
1.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
1.2 请求地址
https://poll.kuaidi100.com/printapi/printtask.do
请求参数：
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| method | 是 | string | 业务类型（默认：printOld） |
| key | 是 | string | 授权码，请申请企业版获取 |
| sign | 是 | string | 32位大写签名，用于验证身份，按MD5 (param +t+key+ secret)的顺序进行MD5加密，不需要加上“+”号。secret在企业管理后台获取 |
| t | 是 | string | 时间戳如：1576123932000 |
| param | 是 | param | 由其他字段拼接 |
param数据结构：
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| taskId | 是 | string | 任务ID |
1.3 返回结果
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| result | boolean | 提交结果 | true提交成功，false失败 |
| returnCode | string | 返回编码 | |
| message | String | 返回报文描述 | |
| data | String | 图片复打时会有返回 |
1.4 提供数据内容
打印设备复打返回示例
{
"result": true,
"returnCode": "200",
"message": "复打成功"
}
返回图片示例：
{
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"imgBase64": "****" // JSONArray格式的String串
}
}
1.5 返回信息代码含义
| 信息代码 | 信息内容描述 | 原因及建议处理方式 |
|---|---|---|
| 200 | 成功 | 提交成功 |
| 201 | 查无此单 | 可能调用过期或复打次数超过限制 |
| 400 | 参数错误 | 请根据技术文档请求，注意参数类型及是否必填。 |
| 500 | 服务器错误 | 快递100的服务器出现间歇或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误 |
| 501 | 重复提交 | 重复提交了请求 |
| 503 | 验证签名失败 | 检查加密方式，param +t+key+ secret的顺序进行MD5加密，加密后字符串转32位大写,不用加上“+”号 |
| 600 | 您不是合法的用户（即授权key出错） | 快递100账号无可用电子面单单量，需要充值 |
| 601 | KEY已过期 | 快递100账号无可用电子面单单量，需要充值 |
