企业微信 API
企业内部开发第三方应用开发智慧硬件开发
企业内部开发第三方应用开发智慧硬件开发
  1. 接口调用
  • 硬件直连接入
    • 概述
    • 设备接入
      • 接入协议概述
      • 接口调用
        • 获取SecretNo
        • 获取服务器时间
        • 设备注册网络
        • 设备激活
        • 设备心跳
        • 获取最新固件信息
        • 上传日志文件
        • 设备登录二维码
        • 上报设备异常事件
        • 获取设备绑定企业信息
        • 触发云端下发指令
      • 回调通知
        • 企业绑定设备事件
        • 企业解绑设备事件
        • 固件升级指令
        • 上传日志文件指令
        • 重启设备指令
      • 蓝牙相关协议
        • 蓝牙识别及配网协议
        • 蓝牙识别及配网SDK
      • 附录
        • 设备比对版本号流程
        • 设备报警及日志上传流程
    • 考勤/门禁设备
      • 接口调用
        • 全量获取用户数据
        • 增量获取用户数据
        • 检查UserId合法性
        • 获取UserId的变更信息
        • 获取通讯录最新版本号
        • 上传识别特征值
        • 增量获取访客数据
        • 获取访客列表最新版本号
        • 上报考勤打卡/门禁通行记录
        • 上报体温检测记录
        • 异步补录体温检测记录
        • 获取设备自助录入开关状态
        • 获取健康码信息
        • 指纹/人脸多算法版本协议
      • 云端下发指令
        • 通讯录变更事件
        • 成员UserId变更事件
        • 访客列表变更事件
        • 设备自助录入开关变更事件
        • 识别信息录入指令
        • 取消识别信息录入指令
        • 远程开门/扫码开门指令
      • 附录
        • 全量拉取通讯录流程
        • 门禁通行规则语法说明
        • 访客UserId规则说明
        • 员工二维码校验规则
        • 访客二维码校验规则
    • 打印/扫描设备
      • 打印/扫描设备接入指引
      • 接口调用
        • 获取身份验证二维码
        • 获取打印任务列表
        • 下载打印文件
        • 上报打印任务状态
        • 上传打印机扫描文件
        • 上报设备自定义属性
        • 带扩展参数的文件上传协议
      • 回调通知
        • 打印任务推送事件
        • 打印任务删除事件
    • 无线投屏设备
      • 无线投屏设备接入指引
      • Andriod系统设备接入
  • 硬件云端接入
    • 设备接入
      • 接口调用
        • 获取设备型号调用凭证
        • 获取设备授权密钥
        • 获取设备调用凭证
        • 录入设备
        • 获取设备详情
        • 更新设备状态
        • 全量获取设备成员列表
        • 获取设备中指定成员的信息
        • 上报设备固件升级结果
      • 回调通知
        • 回调协议相关
        • 企业绑定设备事件
        • 企业解绑设备事件
        • 通讯录变更事件
        • 固件升级指令
        • 设备型号model_ticket推送事件
        • 查询设备SN合法性事件
    • 考勤/门禁设备
      • 接口调用
        • 上报考勤打卡记录
        • 上报体温检测记录
        • 上报门禁通行记录
        • 上报成员识别信息变化结果
        • 上报远程开门结果
      • 回调通知
        • 识别信息录入指令-录入指纹或人脸指令
        • 识别信息录入指令-取消录入指纹或人脸指令
        • 远程开门指令
        • 识别信息删除回调-删除指纹或人脸指令
    • 打印/扫描设备
      • 接口调用
        • 获取打印身份识别二维码
        • 获取打印任务列表
          POST
        • 获取打印文件
          POST
        • 上报打印任务状态
          POST
        • 上传扫描文件
          POST
        • 上报打印机状态变更
          POST
        • 返回转码后的打印文件
          POST
      • 回调通知
        • 推送打印任务
  1. 接口调用

获取打印任务列表

POST
https://qyapi.weixin.qq.com/cgi-bin/openhw/device/get_printer_job_list
本接口适用于云端接入打印机获取打印任务列表。
1.支持分页拉取,分页获取任务时,需填写offset和limit参数,打印机可以根据自身的情况决定分页大小。默认按任务提交时间排序,任务最多存储7天。
2.同时支持按特定jobid来获取任务,jobid_list不填或者填为空调数组则忽略该参数,填写jobid_list时,接口自动忽略status、cursor、offset、limit、begin_time、end_time等参数。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/openhw/device/get_printer_job_list' \
--header 'Content-Type: application/json' \
--data-raw '{
		"open_userid": "zhangsan",
		"status": 0,
		"cursor": 0,
		"limit": 10,
		"begin_time":123,
		"end_time":456,
		"jobid_list":["aa","bb","cc"]
}'
响应示例响应示例
{
  "printer_job_list": [
    {
      "open_userid": "xxxxx",
      "createtime": 12345678,
      "submitted": 1,
      "page_size": 4,
      "status": 0,
      "errcode": 0,
      "errmsg": "ok",
      "doc_name": "aa.doc",
      "doc_size": 3317,
      "jobid": "job_id_xxxxx",
      "setting_list": [
        {
          "key": "纸张大小",
          "value": [
            "A4"
          ]
        },
        {
          "key": "单双面",
          "value": [
            "单面"
          ]
        }
      ]
    },
    {
      "open_userid": "yyyyy",
      "createtime": 12345678,
      "submitted": 0,
      "state": "machine_02",
      "status": 2,
      "errcode": 1,
      "errmsg": "打印机缺纸",
      "jobid": "job_id_yyyyy",
      "doc_name": "bb.pdf",
      "doc_size": 3317,
      "setting_list": [
        {
          "key": "纸张大小",
          "value": [
            "A4"
          ]
        },
        {
          "key": "单双面",
          "value": [
            "单面"
          ]
        }
      ]
    }
  ],
  "errcode": 0,
  "errmsg": "ok",
  "next_cursor": "ssdfasdfa"
}

请求参数

Query 参数
device_access_token
string 
可选
device_access_token ,获取方式见获取设备调用凭证
示例值:
DEVICE_ACCESS_TOKEN
Body 参数application/json
open_userid
string 
成员id
必需
status
integer 
必需
任务状态: 0:获取未打印的任务; 1:获取打印成功的任务; 2:获取打印失败的任务; 不填则获取所有任务
cursor
integer 
请求偏移量
必需
limit
integer 
必需
本次请求任务数,不填默认为100,最大为200
begin_time
integer 
打印任务起始时间
必需
end_time
integer 
打印任务结束时间
必需
jobid_list
array[string]
必需
任务id列表 ,最大支持传入200个jobid
示例

返回响应

🟢200成功
application/json
Body
printer_job_list
array [object {12}] 
打印任务列表
必需
open_userid
string 
必需
成员id,表示该任务是谁提交的
createtime
integer 
任务提交时间
必需
submitted
integer 
必需
表示该任务是否扫码后提交: 0:否 1:是
page_size
integer 
可选
页数,仅当printer_format为jpg时可以忽略该参数
status
integer 
必需
任务状态: 0:未打印 1:打印成功 2:打印失败
errcode
integer 
该任务错误码
必需
errmsg
string 
该任务的错误描述
必需
doc_name
string 
文档名称
必需
doc_size
integer 
必需
文档大小,单位字节,仅当printer_format为jpg时可以忽略该参数
jobid
string 
任务id
必需
setting_list
array [object {2}] 
必需
该任务的一些设置,所有设置都是key-value对
state
string 
可选
errcode
integer 
错误码
必需
errmsg
string 
错误码描述
必需
next_cursor
string 
必需
请求偏移量,当没有next_cursor时表示列表已拉完

【企业微信】API开发者 微信交流群

用微信扫右侧二维码,加入【企业微信】API开发者 交流群,互助沟通

扫码加入交流群
上一页
获取打印身份识别二维码
下一页
获取打印文件
Built with