全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
生成打印机渲染命令(通过打印机命令打印)
接口地址: http://api.vv-tool.com/tool/erps/pdd-cmdprint
接口介绍: isv 进行无线打印,需要将渲染数据传给打印机,通过生成打印机命令的方式能够最大限度的减少移动设备和打印机之间通信数据量。点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 请求次数收费,联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
owner_id | INT | 必填 | 店铺 id |
request | OBJECT | 必填 | request |
client_side_id | STRING | 必填 | 客户端 id |
client_type | STRING | 必填 | 客户端类型 |
config | OBJECT | 必填 | 打印配置 |
horizontal_offset | DOUBLE | 非必填 | 水平偏移 |
need_bottom_logo | BOOLEAN | 非必填 | 是否打印下联 logo |
need_middle_logo | BOOLEAN | 非必填 | 是否打印中联 logo |
need_top_logo | BOOLEAN | 非必填 | 是否打印上联 logo |
orientation | STRING | 必填 | 打印方向 normal-正常 reverse-翻转 |
vertical_offset | DOUBLE | 非必填 | 垂直偏移 |
document | OBJECT | 必填 | 需要打印的文档,包括模板地址,打印数据 |
contents | OBJECT[] | 必填 | 包含的区域列表。对于有自定义区的文档,content 会包含两条,即第一条是标准模板区域内容、第二条是自定义区域内容 |
add_data | STRING | 非必填 | 附加数据(用于修改数据)例如:{ sender:{ address:{ detail:蒋村街道西溪诚园小区 2-1-101 } } } |
encrypted | BOOLEAN | 非必填 | 是否获取加密数据 |
print_data | STRING | 必填 | 打印数据 |
signature | STRING | 非必填 | 数据签名 |
template_url | STRING | 必填 | 模板 url |
ver | STRING | 非必填 | 加密数据使用秘钥版本 |
printer_name | STRING | 必填 | 打印机名称 |
print_command_type | STRING | 必填 | 枚举值:CPCL、TSPL |
cmd_encoding | STRING | 非必填 | 返回值编码方式,枚举值:gzip(默认值)、gzip_byte(推荐值) |
vvtype | INT | 非必填 | 默认:1 1:增强版 增强版专属 |
请求示例
{
"owner_id": "20358278",
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
cloudprint_cmdprint_render_response | OBJECT | response | |
cmd_content | STRING | 指令集内容串 | |
cmd_encoding | STRING | 指令集编码方式枚举。origin: 原串;gzip: 打印指令 string(utf-8 编码)采用 gzip 压缩后再使用 base64 编码;gzip_type: 打印指令字节数组采用 gzip 压缩后再使用 base64 编码。 | |
success | BOOLEAN | 是否成功 | |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"withholding_money":4
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |