文档中心
电子面单复打接口

电子面单重复打印

一、复打接口

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

1.1 接口格式

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

1.2 请求地址

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

请求参数:

参数名是否必填类型说明
methodstring业务类型(默认:printOld)
keystring授权码,请申请企业版获取
signstring32位大写签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号secret在企业管理后台查看
tstring时间戳如:1576123932000
paramparam由其他字段拼接

param数据结构:

参数名是否必填类型说明
taskIdstring任务ID

1.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messageString返回报文描述
dataString图片复打时会有返回

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账号无可用电子面单单量,需要充值
601KEY已过期快递100账号无可用电子面单单量,需要充值