文档中心
一、自定义打印接口 二、附件打印接口 三、打印接口回调 四、自定义生成图片接口 五、硬件状态接口 六、指令打印接口

快递100云打印技术文档

一、自定义打印接口

如有打印发货单等其他类打印需求,可使用该接口。通过管理后台模板配置,配置自定义模板,实现自定义打印功能。

1.1 接口格式

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

1.2 请求地址

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

请求参数(header)

名称类型默认值
Content-Typestringapplication/x-www-form-urlencoded

请求参数(body)

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

param数据结构:

参数名是否必填类型说明
orderIdstring贵司内部自定义的订单编号,需要保证唯一性,非必填
tempidstring通过管理后台的模板信息获取
siidstring打印设备,通过打印机输出的设备码进行获取
heightstring打印纸的高度,以mm为单位,例如:100
widthstring打印纸的宽度,以mm为单位,例如:75
saltstring签名用随机字符串
callBackUrlstring打印状态回调地址,默认仅支持http
******string其他面单特殊需求参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表

1.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
taskIdstring任务ID
************其他报文

1.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "****",  // 任务ID
        ******
  }
}

1.5信息代码含义

代码字段含义
200提交成功
400参数错误
600您不是合法的用户(即授权Key出错)
601KEY已过期
500服务器错误(即快递100的服务器出现间歇或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
501重复提交
503验证签名失败

二、附件打印接口

为各应用产品提供的智能化打印解决方案。对接后可以让企业、个人实现PC/手机无线打印,远程打印,多人共享打印。打印内容包括但不限于文档、发票、发货单、快递单等,搭配云盒使用,支持激光、喷墨、针式、热敏打印机类型。让企业和个人打印更高效、更便捷。 通过接口上传打印内容,图片或PDF、Word等文件,即可打印该内容。

2.1 接口格式

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

2.2 请求地址

https://poll.kuaidi100.com/printapi/printtask.do?method=imgOrder&key={key}&t={t}&param={param}&sign={sign}

请求参数(header)

名称类型默认值
Content-Typestringmultipart/form-data

请求参数(query)

参数名是否必填类型说明
methodstring业务类型(默认:imgOrder)
keystring授权码,请申请企业版获取
signstring32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在企业管理后台的企业信息中查看
tstring时间戳如:1576123932000
Θparamparam由其他字段拼接
└ orderIdstring贵司内部自定义的订单编号,需要保证唯一性,非必填
└ heightstring打印纸的高度,以mm为单位,例如:100
└ widthstring打印纸的宽度,以mm为单位,例如:75
└ copyNumstring需要打印的份数,默认是一份
└ startPagestring打印范围,起始页,仅对多页文件支持,默认是打印整个文档
└ endPagestring打印范围,结束页,仅对多页文件支持,默认是打印整个文档
└ saltstring签名用随机字符串
└ siidstring打印设备,通过打印机输出的设备码进行获取
└ callBackUrlstring打印状态回调地址,默认仅支持http

body数据结构:

参数名是否必填类型说明
filefile需要打印的附件

2.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
taskIdstring任务ID
************其他报文

2.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "****",  // 任务ID 
        ******
    }
}

2.5信息代码含义

代码字段含义
200提交成功
400参数错误
600您不是合法的用户(即授权Key出错)
601KEY已过期
500服务器错误(即快递100的服务器出现间歇或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
501重复提交
503验证签名失败

三、打印接口回调

通过上述接口提交的打印请求,进行打印状态返回。

3.1 接口格式

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

3.2 请求地址

<form method="post" name="" action="[callbackUrl]">
    <input type="text" name="taskId" value="{XXX}" />
    <input type="text" name="param" value="{XXX}" />
    <input type="text" name="sign" value="签名字符串" />
</form>

请求参数:

字段类型说明备注
taskIdstring任务ID
signstring加密字符串签名:MD5 (param +salt)
paramparam参数主体

param数据结构:

参数名类型说明
statusstring状态编码,200:打印成功,201打印不成功
messagestring状态描述

3.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述

3.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功"
}

说明:

字段名称字段含义
resulttrue表示成功,false表示失败。如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃
returnCode200: 提交成功 500: 服务器错误 其他错误请自行定义
message返回的提示

其他信息快递100会忽略。

四、自定义生成图片接口

使用该接口可以自定义生成面单,发货单等的信息图片,并通过本地打印机打印。

4.1 接口格式

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

4.2 请求地址

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

请求参数(header)

名称类型默认值
Content-Typestringapplication/x-www-form-urlencoded

请求参数(body):

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

param数据结构:

参数名是否必填类型说明
typestring业务类型,值为:30
orderIdstring贵司内部自定义的订单编号,需要保证唯一性,非必填
tempidstring通过管理后台的打印模板配置信息获取
heightstring打印纸的高度
widthstring打印纸的宽度
**string其他面单参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表

4.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
taskidstring任务ID
imgBase64string面单BASE64编码图片
************其他报文

4.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "****",     // 任务ID
        "imgBase64": "****",  //面单BASE64编码图片 
         ******
   }
}

4.5 信息代码含义

代码字段含义
200提交成功
400参数错误
600您不是合法的用户(即授权Key出错)
601KEY已过期
500服务器错误(即快递100的服务器出现间歇或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
501重复提交
503验证签名失败

五、 硬件状态接口

获取云打印机设备通讯状态。

5.1 接口格式

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

5.2 请求地址

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

请求参数:

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

param数据结构:

参数名是否必填类型说明
siidstring设备码

5.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
onLinestring设备状态1,在线,0未在线

5.4 提供数据内容

{
    "result": true,
    "returnCode": "200",
    "message": "成功",
    "data": {
          "onLine": "****"  //设备状态
     }
} 

5.5 信息代码含义

信息代码字段含义
200提交成功
400参数错误
600您不是合法的用户(即授权Key出错)
601KEY已过期
500获取失败
503验证签名失败
504获取受限

六、指令打印接口

将原始打印指令进行zlib压缩,并转化为base64之后给到云打印机,实现云打印功能,适用于具有将打印内容转化成打印指令的商家以及从第三方接口(例:菜鸟、拼多多等)获取打印指令的商家(如第三方接口输出的指令已完成base64转化,则可直接通过云打印机打印)。

6.1 接口格式

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

6.2 请求地址

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

请求参数(header)

名称类型默认值
Content-Typestringapplication/x-www-form-urlencoded

请求参数(body)

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

param数据结构:

参数名是否必填类型说明
contentstring可识别打印指令,内容需我司硬件指令进行协商确定
siidstring打印设备,通过打印机输出的设备码进行获取
saltstring签名用随机字符串
callBackUrlstring打印状态回调地址,默认仅支持http

6.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
taskIdstring任务ID

6.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "****",  // 任务ID
        ******
  }
}

6.5信息代码含义

代码字段含义
200提交成功
400参数错误
600您不是合法的用户(即授权Key出错)
601KEY已过期
500服务器错误(即快递100的服务器出现间歇或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
501重复提交
503验证签名失败