智慧硬件开发
智慧硬件开发
硬件云端接入
打印/扫描设备
接口调用
返回转码后的打印文件
返回转码后的打印文件
最后更新:2022/11/09

该接口用于返回转码后的打印文件

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/openhw/device/set_printer_job_trans_result?device_access_token=DEVICE_ACCESS_TOKEN

请求包体:

{	
	"jobid":"jobid_xxx",  
	"setting_version":1,
	"type":1,
	"page":1,
	"page_size":10,
	"media_id":"MEDIAID",
	"download_url":"URL",
	"errcode": 1,
	"errmsg": ""
}

参数说明:

参数是否必须类型说明
device_access_tokenstringdevice_access_token ,获取方式见获取设备调用凭证
jobidstring转码任务id
typeuint320: pdf , 1: jpg ,默认为0
pageuint32当前media_id / download_url 内容图片对应的页码,仅当type为 1时有效且参数必传,页码从1开始
page_sizeuint32转码后的 pdf总页数 / 图片总张数
setting_versionuint32预览转码设置列表 版本号,当用户更改打印配置选项时,version自增,服务商只需要对接收到的最新version进行转码即可
media_idstring二进制对应的mediaid
download_urlstringcdn下载链接,由厂商侧提供(如有),没有cdn能力的厂商可以使用mediaid,当传入download_url时,接口会忽略mediaid字段
errcodeint32转码失败错误码
errmsgstring转码失败错误描述
注:使用mediaid文件大小上限为20M,厂商自带的download_url上限由厂商自行决定。
当上传类型为图片时,转码后的每一页图片需要单独存储为唯一的meidia_id/download_url,对应的page字段用于表明当前media_id/download_url对应的图片对应文档转码后的页码

转码错误码定义

errcodeerrmsg显示描述
1打印盒子暂不支持当前打印机品牌
2文件转码失败,请重试
3文件转码超时,请重试
4暂不支持打印该格式文件
注意:
1. 错误码1-1999预留企业微信内部规范展示错误信息使用,当errcode填1-1999时企业微信将忽略errmsg而使用内部规范的文案
2.如果厂商希望透传错误原因展示到用户侧,errcode请使用2000及其以上的错误码

 

返回结果:

{
 "errcode" : 0,
 "errmsg" : "ok"
 }
       

参数说明:

参数说明
errcode错误码
errmsg错误码对应的描述
上一篇上传扫描文件
下一篇获取打印身份识别二维码
    本节内容
硬件直连接入
更新日志
联系我们