快递100-电商/快递电子面单复打API接口案例

原创

快递100API

修改于 2021-05-20 14:41:35

7840

修改于 2021-05-20 14:41:35

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

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

请求参数：

参数名	是否必填	类型	说明
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

打印设备复打返回示例

{
    "result": true,
    "returnCode": "200",
    "message": "复打成功"
}

返回图片示例：

{
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
      "imgBase64": "****" // JSONArray格式的String串
    }
}

信息代码	信息内容描述	原因及建议处理方式
200	成功	提交成功
201	查无此单	可能调用过期或复打次数超过限制
400	参数错误	请根据技术文档请求，注意参数类型及是否必填。
500	服务器错误	快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误
501	重复提交	重复提交了请求
503	验证签名失败	检查加密方式，param +t+key+ secret的顺序进行MD5加密，加密后字符串转32位大写,不用加上“+”号
600	您不是合法的用户（即授权key出错）	快递100账号无可用电子面单单量，需要充值
601	KEY已过期	快递100账号无可用电子面单单量，需要充值