自定义模板打印接口
POST
https://api.kuaidi100.com/label/order
如有发票、发货单、面单等打印需求，可使用该接口。通过管理后台模板配置，配置自定义模板，实现自定义打印功能。该接口支持在提交打印请求2天内的打印任务进行复打10次的操作
param数据结构：
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| tempid | 是 | string | 通过管理后台的打印模板V2信息获取 |
| printType | 是 | string | 打印类型（IMAGE,CLOUD,HTML）。IMAGE:生成图片短链；HTML:生成html短链；CLOUD:使用快递100云打印机打印，使用CLOUD时siid必填 |
| siid | 否 | string | 打印设备，通过打印机输出的设备码进行获取，printType为CLOUD时必填 |
| direction | 否 | string | 打印方向（默认0） 0-正方向 1-反方向；只有printType为CLOUD有作用 |
| callBackUrl | 否 | string | 打印状态回调地址 |
| customParam | 否 | Map<String,Object> | 自定义参数。方式传入为key-value格式 |
1.6信息代码含义
| 信息代码 | 信息内容描述 | 原因及建议处理方式 |
|---|---|---|
| -1 | 服务器错误 | 快递100的服务器出现间歇或临时性异常，有时如果因为不按规范提交请求，也会报此错误 |
| 200 | 提交成功 | 提交成功 |
| 30001 | 参数错误 | 请根据技术文档请求，注意参数类型及是否必填 |
| 30002 | 验证签名失败 | 检查加密方式，param +t+key+ secret的顺序进行MD5加密，加密后字符串转32位大写,不用加上“+”号 |
| 30003 | 账号信息不正确 | 检查key是否正确 |
| 30004 | 账号单量不足 | 单量不足需要充值 |
| 30006 | 参数转换异常 | 按照描述可以自行检查参数的数据类型是否正确 |
| 30007 | 模板id不正确 | 检查传入tempId是否正确 |
| 30010 | 打印机状态不正确 | 打印机当前状态无法打单，需要检查 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kuaidi100.com/label/order' \
--data-urlencode 'method=' \
--data-urlencode 'key=' \
--data-urlencode 'sign=' \
--data-urlencode 't=' \
--data-urlencode 'param='响应示例响应示例
200 - 成功 - 成功示例
{
"code": 200,
"message": "success",
"time": 0,
"data": {
"taskId": "123123213213"
},
"success": true
}请求参数
Body 参数application/x-www-form-urlencoded
method
string
必需
key
string
必需
sign
string
必需
t
string
必需
param
string
由其他字段拼接
返回响应
扫码加入交流群