1.功能描述
用于在贵方系统发起打印操作,无须页面嵌套,方便快捷地进行快递单打印;调用此接口必须购买快递100云盒或云打印机;
2.接口信息
请求地址 | b.kuaidi100.com/v7/open/api… |
通信协议 | HTTPS |
请求方式 | POST |
字符集 | UTF-8 |
请求Conent-Type | application/x-www-form-urlencoded |
3.请求参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
app_key | String | 是 | 由快递100提供,接入应用的唯一标识 ([快递管家官网API服务],管理中的App Key) |
access_token | String | 是 | 授权注册时获取的access_token(访问令牌) |
timestamp | long | 是 | 时间戳,自1970年01月01日起到现在的秒数, 例: 1502963129 |
sign | String | 是 | 签名,签名算法参照【签名说明】 |
data | String | 是 | Json字符串,贵方的订单信息数据 |
data参数
名称 | 类型(字符长度) | 是否必填 | 描述 |
---|---|---|---|
print_list | String(500) | 是 | 接入方需要打印的订单编号列表,最多一次支持 20 个 订单打印,用英文逗号分隔。 例:O12345,O23456,O34567 |
siid | String(50) | 否 | 云盒、云打印机的设备码,不传时,使用系统默 认配置(需在快递管家绑定快递 100 云盒或云打印机, 并启用“自动打印”功能) |
express_company | String(30) | 否 | 快递公司编码,“订单信息导入接口”未传值时则 此处必填 |
service_type | String(30) | 否 | 业务类型,默认:标准快递 |
示例:
app_key=LeWFeuaGwdf&access_token=uoKbfafdfafcCce×tamp=1502963129&sign=3CF35D130E8B197553ADE1BAEA2615F0&data={
"print_list": "O12345,O23456,O34567",
"express_company": "shunfeng"
}
4.返回参数
名称 | 类型(字符长度) | 是否必填 | 描述 |
---|---|---|---|
status | String(5) | 是 | 200:成功401:失败 |
message | String(30) | 是 | 成功/失败原因 |
示例:
成功:
{
"status": "200",
"message": "success"
}
失败:
{
"status": "401",
"message": "打印机不在线"
}