欢迎!这里是飞印API文档

飞印API文档描述、示例


使用前的准备

测试和部署飞印打印机需要您准备不同的信息和工具。

(免费)测试飞印打印机的准备

您不必购买飞印打印机(终端/硬件)也可以(免费)测试飞印的云打印功能。请参考以下步骤免费进行您的网站/业务系统与飞印打印机的集成测试。

  1. 到 [飞印中心1.0](http://my.feyin.net "飞印中心1.0") 免费注册一个测试用户帐号

  2. 登录 飞印中心1.0 获取以下3个飞印API集成必需的参数:

    • 商户编码( member_code )
    • API密钥( API_KEY )
    • 飞印虚拟打印机的设备编码( deviceNo ),每个用户帐号可以有一个虚拟飞印打印机,对应有1个设备编码(一般为9字开头)。你在编写API集成代码时将需要用到此编码,以便把来自网站/业务系统的信息打印到此虚拟飞印打印机。
  3. 通读本指南,尤其是 飞印API集成示例代码 部分,理解如何编写部署到您网站或业务系统的飞印API集成代码。

  4. 使用您的集成代码(通过网站或业务系统动作)触发飞印打印请求,测试将数据发送到您的飞印虚拟打印机输出。

    备注:飞印中心1.0是飞印团队于2011年在中国开发的一个免费系统,也是在国内早期推出Restful开放接口的硬件服务商之一,当时旨在提供为开发者提供WebAPI开发的试用和熟悉,如今我们依旧保留着系统当年的样子,但2017年后更先进的功能接口以及和对新机型的支持功能请免费注册飞印中心的2.0版本:关注公众号“飞印”。

部署飞印打印机的准备

当你已确定飞印能帮助您加速业务并已购买飞印打印机(终端)后,您需要参考以下步骤实施飞印打印机的部署:

  1. 飞印公众号(微信输入“飞印”搜索公众号即可) 免费注册一个用户帐号。如果你已做过免费集成测试,您也许已了解到调用飞印API必须获取以下3个飞印API集成必需的参数:
    • 商户编码( member_code )
    • API密钥( API_KEY )
    • 已购飞印打印机的设备编码( deviceNo )
  2. 通读本指南,尤其是 飞印API集成示例代码 部分,理解如何编写部署到您网站或业务系统的飞印API集成代码。

  3. 使用您的集成代码(通过网站或业务系统动作)触发飞印打印请求,测试将数据发送到您已购买的飞印打印机输出。

注解

如何知道您购买的飞印打印机的设备编码:在大部分飞印打印机底部均有一颗黑色小按钮,打印机通电情况下按下一次即可打印一张测试页面,里面写有此飞印打印机的设备编码。

同步应用服务器时间

作为飞印API的安全设计之一,飞印API将校验来自您的网站或应用服务器为每个打印请求生成的时间戳,对比飞印云平台服务器的时钟。从发送到收到之间的时延超过60秒的请求将被视为超时,飞印API将拒绝接收此类请求,并返回 -5 状态码—— 请求超时的错误提示。

飞印云平台服务器使用以下时间服务器来校准自身的时钟:125.90.88.37,210.72.145.44,ntp1.cs.mu.OZ.AU, ntp0.cs.mu.OZ.AU,ntp.alaska.edu。

页面列表

ITEM_HTML