接入与使用说明

你想让打印机帮你做什么？

从网上下单、自助打印到内机集成，先找到适合你的用法，再看接入步骤和接口参数。

Developer Docs

不用从头读完。先选你要做的事，按下面的顺序查看文档；已经在开发，可以直接搜“签名”“排队”“回调”或接口名称。

Print orders from your website or app

Send an order to a printer and show its progress and result to your customer.

查看准备事项和使用步骤1篇文档

开始前Prepare a connected printer, its ID and key, an accessible image URL and physical print dimensions. Keep the key on your server.

  1. Receive print updatesProvide a callback endpoint in your system to receive completion and error updates.Print Task Callback

别弄混Submission is not completion. Save the returned task ID. Call Start Print only when the device requires a second confirmation.

查看本类全部文档 · API | Internet →

Run a self-service printer

Let customers place orders while the kiosk prints them and reports the results to your system.

查看准备事项和使用步骤2篇文档

开始前Confirm the kiosk client version, product and channel setup, inventory and callback endpoint. Channels apply only to supported self-service devices.

  1. Receive job and dispensing updatesHandle completion, pause, failure and dispensing using the V2 definitions.Print Task Callback V2 [For Self-Service Kiosks Only]
  2. Receive device alertsRoute device, stock and ink alerts to the operator.Printer Status Callback V2 [For Self-Service Kiosks]

别弄混V2 and legacy callbacks use different status values. Confirm the required client version before using V2.

查看本类全部文档 · Interface - Internet (Self-service Machine) →

遇到问题，先查这里

Cancel this print orderCancel the specified print job. This is not a payment-refund operation.Cancel Specified Print Job →

打开接口文档后，怎么看？

  1. 先看适用范围核对设备类型、客户端版本和接入方式。自助机专属、V2 回调等说明不能跳过。
  2. 再看请求和参数按正文的地址、请求方式和必填字段来调用。taskid、task_id 等参数名以各接口原文为准。
  3. 最后看返回和通知确认业务返回值，不只看 HTTP 是否成功。任务状态、设备状态和不同版本回调的数字含义并不相同。

还没开通账号或不确定设备支持哪种方式？把设备型号、想实现的功能和遇到的问题告诉技术人员，再开始对接。

已有账号，进入控制台查看设备 →