电商快递物流电子面单复打API接口案例

一、复打接口

该接口支持在提交打印请求2天内的打印任务进行复打10次的操作。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://poll.kuaidi100.com/printapi/printtask.do

请求参数：

参数名	是否必填	类型	说明
method	是	string	业务类型（默认：printOld）
key	是	string	授权码，请<a href="https://api.kuaidi100.com/register/enterprise" target="_blank">申请企业版</a>获取
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账号无可用电子面单单量，需要充值

官方文档：
https://api.kuaidi100.com/document/5f702a95f27ea83ce5f37b21.html