能力接入

任务列表

获取当前设备暂停的任务。

接口地址

https://open.aimiaoyin.com/api/v1/watcher/taskList

请求方法

GET

请求参数

参数名 类型 必需 说明
app_id string Y 开放平台申请的appId
sign string Y app签名 (查看接口鉴权)
device_sn string Y 设备SN码

响应参数

参数名 类型 说明
printer_name string 打印机名称
print_document_name string 文件名
print_ticket_id string 打印任务凭证ID
print_total_pages int 文件页数
copies int 文件打印份数
paper_size int (查看纸张类型定义)
duplex int 双面打印,1=单面,2=长边双面
color int 彩色打印,1=黑白,2=彩色
create_time int 任务创建时间

请求示例

app_id=XXXXXXXX&sign=XXXXXXXX&device_sn=XXXXXXXX

响应示例

{
    "code": 200,
    "message": "设备状态",
    "data": [
        {
            "printer_name": "RICOH MP C2011",
            "print_document_name": "xxx.docx",
            "print_ticket_id": "aaa3e86eead5323f53da2d592e3ac5b2",
            "print_total_pages": 1,
            "copies": 1,
            "paper_size": 9,
            "duplex": 2,
            "color": 2,
            "create_time": "1567699784"
        },
        {
            "printer_name": "HP LaserJet Professional P 1102w",
            "print_document_name": "xxx.pptx",
            "print_ticket_id": "2de9e666cb0dbe234015b46318c5710c",
            "print_total_pages": 2,
            "copies": 1,
            "paper_size": 9,
            "duplex": 1,
            "color": 1,
            "create_time": "1567699793"
        }
    ]
}

开始任务

给设备添加打印任务,设备联网获取到任务后将自动读取并执行任务。

接口地址

https://open.aimiaoyin.com/v1/watcher/startPrintJob

请求方法

POST

请求参数

参数名 类型 必需 说明
app_id string Y 开放平台申请的appId
sign string Y app签名 (查看接口鉴权)
device_sn string Y 设备SN码
print_ticket_id string Y 任务ID
callback_url string Y 打印完成回调地址,需要urlencode (查看接收回调方法)

响应参数

参数名 类型 说明

请求示例

app_id=XXXXXXXX&sign=XXXXXXXX&device_sn=XXXXXXXX&print_ticket_id=XXXX&callback_url=http...

响应示例

{
    "code": 200,
    "message": "任务开始已设为开始",
    "data": []
}

任务回调

设备打印完成后,喵印开放平台服务器将会给开发者添加打印任务时填入的callback_url发送POST请求。

注意事项

  • 通过在任务列表时填入的print_ticket_id字段来识别不同的任务。
  • 喵印开放平台服务器只会发送一次请求,在10秒内收不到响应则会断开请求。

回调请求方法

POST

回调数据类型

Content-Type: application/json

回调示例

{
    "out_job_no": "100001",
    "device_sn": "XXXXXXXX",
    "print_result": "1",
    "end_time": "1567590473"
}

回调参数

参数名 类型 说明
out_job_no string 由开发者定义的任务识别号
device_sn string 设备SN码
print_result int 打印完成状态,1=打印完成,0=打印失败
end_time string 完成时间

results matching ""

    No results matching ""