开发者接入引导说明
开发者接入API步骤如下,更多详情请加入:
飞鹅API开放平台5群: 580316262 (新群)
第一步:注册开发者账号
到 https://developer.de.feieyun.com/ (以下统称‘飞鹅云后台’)注册开发者账号,获得UKEY,账号和UKEY是开发者API接入的重要身份识别参数。
第二步:对接API
-
1、
【必接】添加打印机到开发者账户(可批量) Open_printerAddlist
注意:打印之前必须添加SN、KEY到开发者账户(查看打印机身标签)开发者可以在飞鹅管理后台页面人工添加,或者通过本接口程序添加。
-
2、
【必接】打印订单 Open_printMsg
- 3、
删除打印机(可批量)Open_printerDelList
- 4、
修改打印机信息Open_printerEdit
- 5、
清空待打印队列 Open_delPrinterSqs
- 6、
查询订单是否打印成功 Open_queryOrderState
- 7、
查询某台打印机某日订单统计数 Open_queryOrderInfoByDate
- 8、 查询某台打印机状态 Open_queryPrinterStatus
特别声明:
1、请求URL:
对应接口请求对应的URL
具体请参接口文档详情
2、每个请求的参数包含2部分:公共参数和私有参数,详细请看以下对应说明。
3、返回结果皆为json格式数据。
4、以下每个接口只列出私有参数和返回结果的data参数,其他请看请求和返回的公共参数说明。
特别注意:开发者自己写的请求以表单方式提交数据,请求头需要使用Content-Type:
application/x-www-form-urlencoded,请勿使用其它方式提交数据
5、相关SDK下载
点击查看
请求公共参数说明:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称。 |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
返回公共参数说明
| 返回参数名 | 类型 | 说明 |
|---|---|---|
| ret | int | 返回码,正确返回0,【注意:结果正确与否的判断请用此返回参数】,错误返回非零。 |
| msg | string | 结果提示信息,正确返回”ok”,如果有错误,返回错误信息。 |
| data | 不指定 | 数据类型和内容详看私有返回参数data,如果有错误,返回null。 |
| serverExecutedTime | int | 服务器程序执行时间,单位:毫秒。 |
飞鹅云打印服务协议
尊敬的用户:
本服务条款是广州市大枣信息科技有限公司 (以下简称“本公司”)与您就飞鹅云打印服务(以下简称“本服务”)相关事项所订立的有效约定。为获得本服务,服务使用人(以下称“用户”)在注册飞鹅云账号过程中勾选“同意”按钮即表示完全接受本服务下的全部条款。这些服务条款可由本公司随时更新,本服务条款一旦发生变动,本公司将会在相关的页面上提示修改内容。修改后的服务条款一旦在页面上公布即有效代替原来的服务条款。用户可随时访问www.feieyun.com查阅最新服务条款。用户在使用本公司提供的各项服务之前,应仔细阅读本服务条款,如用户不同意本服务条款以及本公司随时对其的修改,请停止使用本服务。
一、声明与承诺
1. 您确认,在您注册成为飞鹅云用户之前,你已充分阅读、理解并接受本协议的全部内容,一旦您使用本服务,即表示您同意遵循本协议之所有约定。
2. 您同意,本公司有权随时对本协议内容进行单方面的变更,并以在本网站公告的方式予以公布,无需另行单独通知您;若您在本协议内容公告变更后继续使用本服务的,表示您已充分阅读、理解并接受修改后的协议内容,也将遵循修改后的协议内容使用本服务;若您不同意修改后的协议内容,您应停止使用本服务。
3. 您声明,在您同意接受本协议并注册成为飞鹅云用户时,您是具有法律规定的完全民事权利能力和民事行为能力,能够独立承担民事责任的自然人、法人或其他组织;本协议内容不受您所属国家或地区的排斥。不具备前述条件的,您应立即终止注册或停止使用本服务。
二、注册相关
在使用本服务前,您必须先行注册,取得本公司提供给您的“飞鹅云账号”(以下简称“该账号”),您同意:
1. 依本服务注册表之提示准确提供并在取得该账号后及时更新您的正确、最新及完整的资料。若有合理理由怀疑您提供的资料错误、不实、过时或不完整的,本公司有权暂停或终止向您提供部分或全部服务。本公司对此不承担任何责任,您将承担因此产生的任何直接或间接支出。
2. 因您未及时更新资料,导致本服务无法提供或提供时发生任何错误,您不得将此作为索取赔偿的理由,您将承担因此产生的一切后果,本公司不承担任何责任。
3. 您应对您的账号负责,只有您本人可以使用该账号,该账号不可转让、不可赠与、不可继承。 您同意,若您丧失全部或部分民事权利能力或民事行为能力,本公司有权根据有效法律文书(包括但不限于生效的法院判决、生效的遗嘱等)处置与您的飞鹅云账号相关的相关信息。
三、账户安全
您将对使用该账号及密码进行的一切操作及言论负完全的责任,您同意:
1. 本公司通过您的用户名和密码识别您的指示,请您妥善保管您的用户名和密码,对于因密码泄露所致的损失,由您自行承担。您保证不向其他任何人泄露该账号及密码,亦不使用其他任何人的“飞鹅云账号”及密码。
2. 如您发现有他人冒用或盗用您的账号及密码或任何其他未经合法授权之情形时,应立即以有效方式通知本公司,要求本公司暂停相关服务。同时,您理解本公司对您的请求采取行动需要合理期限,在此之前,本公司对已执行的指令及(或)所导致的您的损失不承担任何责任。
3. 服务异常处理:您使用本服务时,可能由于网络本身系统问题、ISP运营商相关作业网络连线问题或其他不可抗拒因素,造成本服务无法提供。您确保您所输入的您的资料无误,如果因资料错误造成本公司于上述异常状况发生时,无法及时通知您相关交易后续处理方式的,本公司不承担任何损害赔偿责任。
4. 您同意,基于运行和安全的需要,本公司可以暂时停止提供或者限制本服务部分功能,或提供新的功能,在任何功能减少、增加或者变化时,只要您仍然使用本服务,表示您仍然同意本协议或者变更后的协议。
四、服务内容
1. 本条款中“服务”指:飞鹅云向您提供www.feieyun.com网站上所展示的云打印服务以及相关的技术及网络支持服务。
2. 飞鹅云提供的服务必须符合本服务条款的约定。
五、服务费用
1. 飞鹅云服务结算方式、计费标准以飞鹅云官网公布价格为准,以人民币计算,双方另有约定的除外。
2. 您理解并同意,飞鹅云目前为您提供免费的云打印服务,即您开通或使用云打印服务,并不需向飞鹅云支付费用;飞鹅云不排除日后收取费用的可能,届时飞鹅云将提前30个自然日通过在网站内合适版面发布公告或发送站内通知等方式公布收费政策及规范;如您仍使飞鹅云打印服务的,应按届时有效的收费政策及规范付费并应遵守届时飞鹅云公布的有效的服务条款。
3. 飞鹅云保留在您未按照约定支付全部费用之前不向您提供服务和/或技术支持,或者终止服务和/或技术支持的权利。同时,飞鹅云保留对后付费服务中的欠费行为追究法律责任的权利。
4. 您完全理解飞鹅云价格体系中所有的赠送服务项目或活动均为飞鹅云在正常服务价格之外的一次性特别优惠,优惠内容不包括赠送服务项目的修改、更新及维护费用,并且赠送服务项目不可折价冲抵服务价格。
六、权利义务
1. 您的权利、义务
1.1. 您同意遵守本服务条款以及服务展示页面的相关管理规范及流程。您了解上述协议及规范等的内容可能会不时变更。如本服务条款的任何内容发生变动,飞鹅云应通过提前30天在 www.feieyun.com 的适当版面公告向您提示修改内容。如您不同意飞鹅云对本服务条款相关条款所做的修改,您有权停止使用飞鹅云的服务,此等情况下,飞鹅云应与您进行服务费结算(如有),并且您应将业务数据迁出。如您继续使用飞鹅云服务,则视为您接受飞鹅云对本服务条款相关条款所做的修改。
1.2. 您应按照飞鹅云的页面提示及本服务条款的约定支付相应服务费用。
1.3. 您承诺:
1.3.1. 如果您利用飞鹅云提供的服务进行经营或非经营的活动需要获得国家有关部门的许可或批准的,应获得该有关的许可或批准。您理解并认可,您应获得有关的许可或批准,并应符合国家及地方不时颁布相关法律法规之要求。
1.3.2. 除飞鹅云明示许可外,不得修改、翻译、改编、出租、转许可、在信息网络上传播或转让飞鹅云提供的服务或软件,也不得逆反编译或试图以其他方式发现飞鹅云提供的服务或软件的源代码;
1.3.3. 若飞鹅云的服务涉及第三方软件之许可使用的,您同意遵守相关的许可协议的约束;
1.3.4. 不利用飞鹅云提供的资源和服务储存、打印如下信息或者内容,不为他人发布该等信息提供任何便利:
1.3.4.1. 违反国家规定的政治宣传和/或新闻信息;
1.3.4.2. 涉及国家秘密和/或安全的信息;
1.3.4.3. 封建迷信和/或淫秽、色情、下流的信息或教唆犯罪的信息;
1.3.4.4. 博彩有奖、赌博游戏、“私服”、“外挂”等非法互联网出版活动;
1.3.4.5. 违反国家民族和宗教政策的信息;
1.3.4.6. 妨碍互联网运行安全的信息;
1.3.4.7. 侵害他人合法权益的信息和/或其他有损于社会秩序、社会治安、公共道德的信息或内容;
1.3.4.8. 其他违反法律法规、部门规章或国家政策的内容。
1.3.5. 不应大量占用,亦不得导致如程序或进程等大量占用飞鹅云服务资源,甚至导致飞鹅云服务不可访问;
1.3.6. 不进行任何改变或试图改变飞鹅云提供的系统配置或破坏系统安全的行为;
1.3.7. 不从事其他违法、违规或违反飞鹅云服务条款的行为。
1.3.8. 如飞鹅云发现您违反上述条款的约定,有权根据情况采取相应的处理措施,包括但不限于立即终止服务、中止服务或删除相应信息等。如果第三方机构或个人对您提出质疑或投诉,飞鹅云将通知您,您有责任在规定时间内进行说明并出具证明材料,如您未能提供相反证据或您逾期未能反馈的,飞鹅云将采取包括但不限于立即终止服务、中止服务或删除相应信息等处理措施。因您未及时更新联系方式或联系方式不正确而致使未能联系到您的,亦视为您逾期未能反馈。
1.4. 您对自己存放在飞鹅云云平台上的数据以及进入和管理飞鹅云云平台上各类产品与服务的口令、密码的完整性和保密性负责。因您维护不当或保密不当致使上述数据、口令、密码等丢失或泄漏所引起的一切损失和后果均由您自行承担。
1.5. 您应向飞鹅云提交执行本服务条款的联系人和管理用户网络及云平台上各类产品与服务的人员名单和联系方式并提供必要的协助。如以上人员发生变动,您应自行将变动后的信息进行在线更新并及时通知飞鹅云。因您提供的人员的信息不真实、不准确、不完整,以及因以上人员的行为或不作为而产生的结果,均由您负责。
1.6. 您对您存放在飞鹅云云平台上的数据内容负责,如因上传、发布的公开信息违反法律法规、部门规章或国家政策,由此造成的全部结果及责任由您自行承担。
1.7.您理解并认可,飞鹅云平台仅能以普通或非专业人员的知识水平标准对您在入驻环节填写或提交的入驻资料、入驻信息进行形式审核、表面识别,且飞鹅云平台保留抽查、要求您补充提交、及时更新入驻材料及入驻信息的权利。
1.8. 您了解飞鹅云无法保证其所提供的服务毫无瑕疵,但飞鹅云承诺不断提升服务质量及服务水平。所以您同意:即使飞鹅云提供的服务存在瑕疵,但上述瑕疵是当时行业技术水平所无法避免的,其将不被视为飞鹅云违约。您同意和飞鹅云一同合作解决上述瑕疵问题。
1.9. 飞鹅云不保证完全备份用户订单数据,亦不对用户订单数据备份工作或结果承担任何责任。
2. 飞鹅云的权利、义务
2.1. 飞鹅云应按照服务条款约定提供服务。
2.2. 飞鹅云为付费用户提供6×8售后电话咨询服务和在线服务系统(包括不限于微信,QQ,邮件等),解答客户在使用中的问题。
2.3. 飞鹅云执行7×24小时故障维护保障,将及时处理发生的问题,但因您原因和/或不可抗力以及非飞鹅云控制范围之内的事项除外。
2.4. 您理解并认可,飞鹅云在必要时将会对您使用的云打印服务进行维护,包括不限于升级,服务器迁移等。维护期间可能造成短暂服务中断。
七、用户数据的保存和删除
1. 您存放在飞鹅云上的订单数据为您所有,飞鹅云除进行必要的统计分析外,不进行任何未获授权的使用及披露,除非:
1.1. 根据法律的有关规定、行政或司法等机构的要求,向第三方或者行政、司法等机构披露;
1.2. 您和飞鹅云另行协商一致的;
1.3. 如果您出现违反中国有关法律法规的情况,需要向第三方披露;
1.4. 为提供您所要求的软件或服务,而必须和第三方分享您数据;但前述披露仅在为您提供服务的必要范围内,且飞鹅云要求第三方承诺,第三方应仅为提供服务目的使用其获得的数据且按照不低于本服务条款的标准对其获得的数据承担保密义务。
1.5. 如果用户订单数据已经被打印,则飞鹅云不承诺其存储期限;如果用户订单数据未被打印,飞鹅云将根据资源情况予以存储1~7个自然日,超过保存期限,飞鹅云将自动删除订单数据。
八、知识产权和其他法律风险
1. 您应保证提交飞鹅云的订单数据、对飞鹅云服务的使用及使用飞鹅云服务所产生的成果未侵犯任何第三方的合法权益。如有第三方基于侵犯版权、侵犯第三人之权益或违反中国法律法规或其他适用的法律等原因而向飞鹅云提起索赔、诉讼或可能向其提起诉讼,则您应赔偿飞鹅云因此承担的费用或损失,并使飞鹅云完全免责。
2. 如果第三方机构或个人对您使用飞鹅云服务所涉及的知识产权归属提出质疑或投诉,您有责任出具相关知识产权证明材料,并配合飞鹅云相关投诉处理工作。
3. 您承认飞鹅云向您提供的任何资料、技术或技术支持、软件、服务等的知识产权均属于飞鹅云或第三方所有。除飞鹅云或第三方明示同意外,您无权复制、传播、转让、许可或提供他人使用上述资源,否则应承担相应的责任。
4. 如因您提交飞鹅云的订单数据、对飞鹅云服务的使用及使用飞鹅云服务所产生的成果造成他人损失的,与飞鹅云平台无关,由您承担相应的全部赔偿责任。如飞鹅云平台和合作方基于前述情况向他人先行赔付或遭受其他损失的,飞鹅云平台有权向您进行追偿(包括但不限于支付罚款、给付赔偿金或律师费等)。
九、保密条款
1. 保密资料指由一方向另一方披露的所有技术及非技术信息(包括但不限于产品资料,产品计划,价格,财务及营销规划,业务战略,客户信息,客户数据,研发资料,软件硬件,API应用数据接口,技术说明,设计,特殊公式,特殊算法等)。
2. 本服务条款任何一方同意对获悉的对方之上述保密资料予以保密,并严格限制接触上述保密资料的员工遵守本条之保密义务。除非国家机关依法强制要求或上述保密资料已经进入公有领域外,接受保密资料的一方不得对外披露。
3. 本服务条款双方明确认可保密资料是双方的重点保密信息并是各自的重要资产,本服务条款双方同意尽最大的努力保护上述保密资料等不被披露。一旦发现有上述保密资料泄露事件,双方应合作采取一切合理措施避免或者减轻损害后果的产生。
4. 本条款不因本服务条款的终止而失效。
十、期限与终止
1. 发生下列情形,服务期限提前终止:
1.1. 双方协商一致提前终止的;
1.2. 您严重违反本服务条款(包括但不限于a.您未按照协议约定履行付款义务,及/或b.您严重违反法律规定等),飞鹅云有权提前终止服务,并不退还您已经支付的费用;
1.3. 您理解并充分认可,虽然飞鹅云已经建立(并将根据技术的发展不断完善)必要的技术措施来防御包括计算机病毒、网络入侵和攻击破坏(包括但不限于DDOS)等危害网络安全的事项或行为(以下统称该等行为),但鉴于网络安全技术的局限性、相对性以及该等行为的不可预见性,飞鹅云可决定暂停或终止服务,如果终止服务的,将按照实际提供服务月份计算(不足一个月的按一个月计)服务费用,将剩余款项(如有)返还。
1.4. 飞鹅云可提前30天在 www.feieyun.com 上通告或给您发网站内通知或书面通知的方式终止本服务条款。届时飞鹅云应将您已支付但未消费的款项退还至您的飞鹅云账户。
十一、违约责任
1. 本服务条款任何一方违约均须依法承担违约责任。
2. 您理解,鉴于计算机、互联网的特殊性,下述情况不属于飞鹅云违约:
2.1. 飞鹅云在进行服务器配置、维护时,需要短时间中断服务;
2.2. 由于Internet上的通路阻塞造成订单打印延时等情况;
3. 如因飞鹅云原因,造成您连续72小时不能正常使用服务的,您可以终止服务,但非飞鹅云控制之内的原因引起的除外。
4. 在任何情况下,飞鹅云均不对任何间接性、后果性、惩戒性、偶然性、特殊性的损害,包括您使用飞鹅云服务而遭受的利润损失承担责任(即使您已被告知该等损失的可能性)。
5. 在任何情况下,飞鹅云对本服务条款所承担的违约赔偿责任总额不超过违约服务对应之服务费总额。
十二、不可抗力
1. 因不可抗力或者其他意外事件,使得本服务条款的履行不可能、不必要或者无意义的,遭受不可抗力、意外事件的一方不承担责任。
2. 不可抗力、意外事件是指不能预见、不能克服并不能避免且对一方或双方当事人造成重大影响的客观事件,包括但不限于自然灾害如洪水、地震、瘟疫流行等以及社会事件如战争、动乱、政府行为、电信主干线路中断、黑客、网路堵塞、电信部门技术调整和政府管制等。
十三、法律适用及争议解决
1. 本服务条款受中华人民共和国法律管辖。
2. 在执行本服务条款过程中如发生纠纷,双方应及时协商解决。协商不成时,任何一方可直接向广州市南沙区人民法院提起诉讼。
十四、附则
1. 飞鹅云在 www.feieyun.com 相关页面上的服务说明、价格说明和您确认同意的订购页面是本服务条款不可分割的一部分。如果 www.feieyun.com 相关页面上的服务说明、价格说明和您确认同意的订购页面与本服务条款有不一致之处,以本服务条款为准。
2. 飞鹅云有权以提前30天在 www.feieyun.com 上公布、或给您发网站内通知或书面通知的方式将本服务条款的权利义务全部或者部分转移给飞鹅云的关联公司。
3. 如果任何条款在性质上或其他方面理应在此协议终止时继续存在,那么应视为继续存在的条款,这些条款包括但不局限于保证条款、保密条款、知识产权条款、法律适用及争议解决条款。
批量添加打印机,Open_printerAddlist
功能描述:
批量添加打印机,请严格参照格式说明:
批量添加规则:
打印机编号SN(必填) # 打印机识别码KEY(必填) # 备注名称(选填) # 流量卡号码(选填),多台打印机请换行(\n)添加新打印机信息,每次最多100行(台)。
每次最多添加100台。例如:
316500010 # abcdefgh # 快餐前台 # 13688889999 316500011 # abcdefgh # 快餐厨房 # 13688889990
请求URL:
https://api.de.feieyun.com/Api/Open/printerAddlist
请求方式:
POST(推荐),GET
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_printerAddlist |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| printerContent | 必须 | string | 打印机编号(必填) # 打印机识别码(必填) # 备注名称(选填) # 流量卡号码(选填),多台打印机请换行(\n)添加新打印机信息,每次最多100台。 |
返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | array | 返回1个数组,包含成功和失败的信息,详看示例。 |
返回示例:
正确:
{ "ok":[ "316500010# abcdefgh# 快餐前台 # 13688889999 ", "316500011# abcdefgh# 快餐前台 # 13688889999 " ], "no":[ "316500012 # abcdefgh # 快餐前台 # 13688889999 (错误:识别码不正确)" ]}
错误:
{ "msg":"参数错误 : 该帐号未注册.", "ret":-2, "data":null, "serverExecutedTime":37}
打印订单,Open_printMsg
功能描述:
发送用户需要打印的订单内容给飞鹅云小票打印机 (该接口只能是小票机使用,如购买标签机请使用标签机专用接口)
请求URL:
https://api.de.feieyun.com/Api/Open/printMsg
请求方式:
POST(推荐),GET
特别注意:
开发者自己写的请求以表单方式提交数据,请求头需要使用Content-Type: application/x-www-form-urlencoded,请勿使用其它方式提交数据
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_printMsg |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| sn | 必须 | string | 打印机编号 |
| content | 必须 | string | 打印内容,不能超过5000字节 |
| times | int | 打印次数,默认为1。 |
排版控制标签说明:(详情请参考SDK示例)
- <BR> :换行符
- <CUT> :切刀指令(主动切纸,仅限切刀打印机使用才有效果)
- <LOGO> :打印LOGO指令(前提是预先在机器内置LOGO图片)
- <PLUGIN> :钱箱或者外置音响指令
- <CB></CB>:居中放大
- <B></B>:放大一倍
- <C></C>:居中
- <L></L>:字体变高一倍
- <W></W>:字体变宽一倍
- <QR></QR>:二维码(单个订单,最多只能打印一个二维码)
- <RIGHT></RIGHT>:右对齐
- <BOLD></BOLD>:字体加粗
字体效果示例图:

排版对齐效果图:

返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | string | 正确返回订单ID。 |
返回示例:
正确:
{ "msg":"ok", "ret":0, "data":"816501678_20160919184316_1419533539", "serverExecutedTime":3 }
错误:
{ "msg":"参数错误 : 该帐号未注册.", "ret":-2, "data":null, "serverExecutedTime":37}
标签机打印订单,Open_printLabelMsg
功能描述:
发送用户需要打印的订单内容给飞鹅云标签打印机(该接口只能是标签机使用,其它型号打印机请勿使用该接口)
请求URL:
https://api.de.feieyun.com/Api/Open/printLabelMsg
请求方式:
POST(推荐),GET
特别注意:
1、开发者自己写的请求以表单方式提交数据,请求头需要使用Content-Type: application/x-www-form-urlencoded,如需打印图片,请求头需要使用Content-Type: multipart/form-data,请勿使用其它方式提交数据; 2、1mm=8dots。
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_printLabelMsg |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| sn | 必须 | string | 打印机编号 |
| content |
content 或 contents 必须 |
string | 打印内容,不能超过5000字节 |
| contents |
content 或 contents 必须 |
string | |
| times | int | 打印次数,默认为1。 | |
| img | binary | 图片二进制数据,需配合<IMG>标签使用,最佳效果为不大于224px的正方形(宽高都为8的倍数)黑白图,支持jpg、png、bmp,不能超过10K |
排版控制标签说明:
- <FEED> :走纸
- <SIZE>width,height</SIZE>:设置卷标纸宽高,width 标签纸的宽度(不含背纸),height 标签纸的高度(不含背纸),单位mm,如<SIZE>30,20</SIZE>
- <GAP>m,n</GAP> :设定两张卷标纸间的垂直间距距离,m 两标签纸中间的垂直距离 0≤m≤25.4(mm),n 垂直间距偏移 n≤标签纸纸张长度,单位mm, 如<GAP>7.62,-2.54</GAP>
- <DIRECTION>n</DIRECTION> :设定打印时出纸和打印字体的方向,n 0 或 1,每次设备重启后都会初始化为 0 值设置,1:正向出纸,0:反向出纸, 如<DIRECTION>1</DIRECTION>
- <IMG x="10" y="100">:打印图片,需配合上传img图片二进制数据使用(一张订单只能打印一次),其中属性x为水平方向起始点坐标(默认为0),属性y为垂直方向起始点坐标(默认为0)
- <QR x="10" y="100" e="L" w="5">二维码内容</QR>:打印二维码,其中属性x为水平方向起始点坐标(默认为0),属性y为垂直方向起始点坐标(默认为0),属性e为纠错等级: L 7%M 15%Q 25%H 30%(默认为L),属性w为二维码宽度(默认为5)
- <TEXT x="10" y="100" font="12" w="2" h="2" r="0">文本内容</TEXT>:打印文本,其中属性x为水平方向起始点坐标(默认为0),属性y为垂直方向起始点坐标(默认为0),属性font为字体:
- 1、 8×12 dot 英数字体 2、 12×20 dot 英数字体 3、 16×24 dot 英数字体 4、 24×32 dot 英数字体 5、 32×48 dot 英数字体 6、 14×19 dot 英数字体 OCR-B 7、 21×27 dot 英数字体 OCR-B 8、 14×25 dot 英数字体 OCR-A 9、 9×17 dot 英数字体 10、 12×24 dot 英数字体 11、 繁体中文 24×24Font(大五码) 12、 简体中文 24×24Font(GB 码) 13、 韩文 24×24Font(KS 码) 默认为12 简体中文 24×24Font(GB 码),属性w为文字宽度放大倍率1-10(默认为1),属性h为文字高度放大倍率1-10属性r为文字旋转角度(顺时针方向): 0 0度 90 90度 180 180度 270 270度(默认为0)
- <BC128 x="10" y="100" h="80" s="1" r="0" n="1" w="1">12345678</BC128>:打印code128一维码,其中属性x为水平方向起始点坐标(默认为0),属性y为垂直方向起始点坐标(默认为0),属性s是否人眼可识:0 不可识,1 可识(默认为1), 属性n为窄 bar 宽度,以点(dot)表示(默认为1),属性w为宽 bar 宽度(默认为1),以点(dot)表示,属性r为文字旋转角度(顺时针方向): 0 0度 90 90度 180 180度 270 270度(默认为0)
- <BC39 x="10" y="100" h="80" s="1" r="0" n="1" w="1">12345678</BC39>:打印code39一维码,其中属性x为水平方向起始点坐标(默认为0),属性y为垂直方向起始点坐标(默认为0),属性s是否人眼可识:0 不可识,1 可识(默认为1),属性n为窄bar宽度,以点(dot)表示(默认为1),属性w为宽 bar 宽度(默认为2),以点(dot)表示,属性r为文字旋转角度(顺时针 方向): 0 0度 90 90度 180 180度 270 270度(默认为0)
- <LOGO x="10" y="100">:打印LOGO指令(前提是预先在机器内置LOGO图片),其中属性x为水平方向起始点坐标(默认为0),属性y为垂直方向起始点坐标(默认为0)
不干胶标签机效果示例图:

返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | string | 正确返回订单ID。 |
返回示例:
正确:
{ "msg":"ok", "ret":0, "data":"816501678_20160919184316_1419533539", "serverExecutedTime":3 }
错误:
{ "msg":"参数错误 : 该帐号未注册.", "ret":-2, "data":null, "serverExecutedTime":37}
删除批量打印机,Open_printerDelList
功能描述:
删除批量打印机
请求URL:
https://api.de.feieyun.com/Api/Open/printerDelList
请求方式:
POST(推荐),GET
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_printerDelList |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| snlist | 必须 | string | 打印机编号,多台打印机请用减号“-”连接起来。 |
返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | array | 返回1个数组,包含成功和失败的信息,详看示例。 |
返回示例:
正确:
{"ok":["800000777成功","915500104成功"],"no":["800000777用户UID不匹配"]}
错误:
{ "msg":"参数错误 : 该帐号未注册.", "ret":-2, "data":null, "serverExecutedTime":37}
修改打印机信息,Open_printerEdit
功能描述:
修改打印机信息。
请求URL:
https://api.de.feieyun.com/Api/Open/printerEdit
请求方式:
POST(推荐),GET
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_printerEdit |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| sn | 必须 | string | 打印机编号 |
| name | 必须 | string | 打印机备注名称 |
| phonenum | string | 打印机流量卡号码 |
返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | bool | 正确返回true。 |
返回示例:
正确:
{ "msg":"ok", "ret":0, "data":true, "serverExecutedTime":9}
错误:
{ "msg":"参数错误 : 时间格式不正确。", "ret":1001, "data":null, "serverExecutedTime":37}
清空待打印队列,Open_delPrinterSqs
功能描述:
修改打印机信息。
请求URL:
https://api.de.feieyun.com/Api/Open/delPrinterSqs
请求方式:
POST(推荐),GET
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_delPrinterSqs |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| sn | 必须 | string | 打印机编号 |
返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | bool | 正确返回true。 |
返回示例:
正确:
{ "msg":"ok", "ret":0, "data":true, "serverExecutedTime":9 }
错误:
{ "msg":"参数错误 : 时间格式不正确。", "ret":1001, "data":null, "serverExecutedTime":37}
查询订单是否打印成功,Open_queryOrderState
功能描述:
根据订单ID,去查询订单是否打印成功,订单ID由接口Open_printMsg返回
请求URL:
https://api.de.feieyun.com/Api/Open/queryOrderState
请求方式:
POST(推荐),GET
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_queryOrderState |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| orderid | 必须 | string | 订单ID,由接口Open_printMsg返回。 |
返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | bool | 已打印返回true,未打印返回false。 |
返回示例:
正确:
{ "msg":"ok", "ret":0, "data":true, "serverExecutedTime":2 }
错误:
{ "msg":"参数错误 : 该帐号未注册.", "ret":-2, "data":null, "serverExecutedTime":37}
查询指定打印机某天的订单统计数,Open_queryOrderInfoByDate
功能描述:
查询指定打印机某天的订单详情,返回已打印订单数和等待打印数。
请求URL:
https://api.de.feieyun.com/Api/Open/queryOrderInfoByDate
请求方式:
POST(推荐),GET
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_queryOrderInfoByDate |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| sn | 必须 | string | 打印机编号 |
| date | 必须 | string | 查询日期,格式YY-MM-DD,如:2016-09-20 |
返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | array | 返回已打印订单数和等待打印数。 |
返回示例:
正确:
{ "msg":"ok", "ret":0, "data":{"print":6,"waiting":1}, "serverExecutedTime":9 }
错误:
{ "msg":"参数错误 : 时间格式不正确。", "ret":1001, "data":null, "serverExecutedTime":37}
获取某台打印机状态,Open_queryPrinterStatus
功能描述:
查询指定打印机状态,返回该打印机在线或离线,正常或异常的信息。
请求URL:
https://api.de.feieyun.com/Api/Open/queryPrinterStatus
请求方式:
POST(推荐),GET
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_queryPrinterStatus |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| sn | 必须 | string | 打印机编号 |
返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | string | 返回打印机状态信息。共三种:
1、离线。 2、在线,工作状态正常。 3、在线,工作状态不正常。 备注:异常一般是无纸,离线的判断是打印机与服务器失去联系超过2分钟。 |
返回示例:
正确:
{ "msg":"ok", "ret":0, "data":"在线,工作状态正常", "serverExecutedTime":9 }
错误:
{ "msg":"参数错误 : 时间格式不正确。", "ret":1001, "data":null, "serverExecutedTime":37}
查询设备类型,Open_getModel
功能描述:
查询指定设备硬件类型(例:58mm 热敏打印机 / 标签打印机),本接口不校验绑定关系,建议用于设备添加前查询获取设备硬件类型。
请求URL:
https://api.de.feieyun.com/Api/Open/getModel
请求方式:
POST
公共参数:
| 请求参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user | 必须 | string | 飞鹅云后台注册用户名。 |
| stime | 必须 | int | 当前UNIX时间戳,10位,精确到秒。 |
| sig | 必须 | string | 对参数 user+UKEY+stime拼接后(+号表示连接符)进行SHA1加密得到签名,值为40位小写字符串。 |
| apiname | 必须 | string | 请求的接口名称:Open_getModel |
| debug | string | debug=1返回非json格式的数据。仅测试时候使用。 |
私有参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| sn | 必须 | string | 设备编号 |
| key | 必须 | string | 设备密钥 |
返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | string | model,返回设备类型:
0:58mm 热敏打印机 1:80mm 热敏打印机 2:桌面式标签打印机 3:出餐宝 4:58 票据打印+扫码一体机 |
返回示例:
正确:
{ "msg":"ok", "ret":0, "data": { "model":2 },
"serverExecutedTime":19 }
错误:
{ "msg":"参数错误 : 时间格式不正确。", "ret":1001, "data":null, "serverExecutedTime":37}
公共参数异常
| 状态 | 返回码 | 返回的JSON | 编码解析 | 解决办法 | |
|---|---|---|---|---|---|
| SIG错误 | -3 | USER,UKEY,时间戳错误 | {"msg":"\u9a8c\u8bc1\u5931\u8d25 : \u7b7e\u540d\u9519\u8bef.","ret":-3,"data":null,"serverExecutedTime":1} | 验证失败 : 签名错误 | 检查UKEY是否正确(UKEY不是打印机的key),不要有空格,UKEY在管理后台(https://developer.de.feieyun.com/)的个人中心有写 |
| 参数为空 | -2 | 参数为空 | {"msg":"\u53c2\u6570\u9519\u8bef : \u53c2\u6570\u503c\u4e0d\u80fd\u4f20\u7a7a\u5b57\u7b26\uff0c\"\"\u3001\"null\"\u3001\"undefined\".","ret":-2,"data":null,"serverExecutedTime":1} | 参数错误 : 参数值不能传空字符 | 检查代码调试,提供正常的参数过来 |
| 请求头错误 | -2 | 请求头错误 | {"msg":"\u53c2\u6570\u9519\u8bef : \u8be5\u5e10\u53f7\u672a\u6ce8\u518c.","ret":-2,"data":null,"serverExecutedTime":22} | 参数错误 : 该帐号未注册 | 账号填写错误,请求头不正确,可以下载官方SDK测试对比参考 |
| 编号和用户不匹配 | 1002 | 打印机编号和用户不匹配. | {"msg":"\u9a8c\u8bc1\u5931\u8d25 : \u6253\u5370\u673a\u7f16\u53f7\u548c\u7528\u6237\u4e0d\u5339\u914d.","ret":1002,"data":null,"serverExecutedTime":3} | 打印机编号和用户不匹配 | 打印机编号没有绑定在当前飞鹅云账号,请核对当前编号绑定情况,填写正确的编号 |
| 时间戳和标准时间相差太大 | -3 | stime 参数值错误 | {"msg":"\u9a8c\u8bc1\u5931\u8d25 : \u8bf7\u6c42\u8d85\u65f6.","ret":-3,"data":null,"serverExecutedTime":7} | 验证失败 : 请求超时. | 接口的 stime 参数异常,和当前北京时间相差太大,矫正服务器时间,代码获取到正确的时间戳即可 |
添加打印机接口
| 状态 | 返回码 | 返回的JSON | 编码解析 | 解决办法 | |
|---|---|---|---|---|---|
| 成功 | 0 | 添加成功 | {"msg":"ok","ret":0,"data":{"ok":["123456789#qw3rtyui"],"no":[]},"serverExecutedTime":6} | 成功 | |
| 已添加 | 0 | 打印机已被添加过 | {"msg":"ok","ret":0,"data":{"ok":[],"no":["123456789#qw3rtyui \uff08\u9519\u8bef\uff1a\u5df2\u88ab\u6dfb\u52a0\u8fc7\uff09"]},"serverExecutedTime":4} | 错误:已被添加过 | 当前打印机已绑定到该账号,代码判断一下不需要再次添加 |
| 绑定的账号超出 | 0 | 绑定账号超出 | {"msg":"ok","ret":0,"data":{"ok":[],"no":["123456789#qw3rtyui \uff08\u9519\u8bef\uff1a\u4e00\u53f0\u6253\u5370\u673a\u6700\u591a\u53ea\u80fd\u7ed1\u5b9a 3 \u4e2a\u8d26\u6237\u3002\uff09"]},"serverExecutedTime":4} | 验证失败 : 一台打印机最多只能绑定 3 个账户 | 绑定的飞鹅云超出,登录以前绑定的飞鹅云账号删除打印机,然后才可以把打印机绑定在当前账号 |
| 失败 | 0 | 打印机编号和KEY错误 | {"msg":"ok","ret":0,"data":{"ok":[],"no":["123456789#n4995eb \uff08\u9519\u8bef\uff1a\u6253\u5370\u673a\u7f16\u53f7\u548cKEY\u4e0d\u6b63\u786e\uff09"]},"serverExecutedTime":2} | 参数错误 : 打印机编号和KEY不正确 | 检查代码,填写打印机底部正确的编号和key即可 |
| 失败 | 1001 | 参数错误 | {"msg":"\u53c2\u6570\u9519\u8bef : \u6279\u91cf\u6dfb\u52a0\u7684\u5185\u5bb9\u4e0d\u80fd\u4e3a\u7a7a.","ret":1001,"data":null,"serverExecutedTime":1} | 参数错误 : 批量添加的内容不能为空. | 检查接口代码,不传空值即可 |
打印订单接口
| 状态 | 返回码 | 返回的JSON | 编码解析 | 解决办法 | |
|---|---|---|---|---|---|
| 失败 | -2 | 订单内容为空 | {"msg":"\u53c2\u6570\u9519\u8bef : \u53c2\u6570\u503c\u4e0d\u80fd\u4f20\u7a7a\u5b57\u7b26\uff0c\"\"\u3001\"null\"\u3001\"undefined\".","ret":-2,"data":null,"serverExecutedTime":1} | 参数错误 : 参数值不能传空字符 | 检查接口代码,不传空值即可 |
| 成功 | 0 | 接口返回订单ID | {"msg":"ok","ret":0,"data":"123456789_20180511092952_115933399","serverExecutedTime":3} | 成功 | |
| 失败 | 1001 | 订单内容超过5000字 | {"msg":"\u53c2\u6570\u9519\u8bef : \u6253\u5370\u5931\u8d25\uff0c\u6253\u5370\u5185\u5bb9\u8d85\u8fc7 5000 \u5b57\u8282.","ret":1001,"data":null,"serverExecutedTime":1} | 参数错误 : 打印失败,打印内容超过 5000 字节 | 超出5000字节的,程序代码判断一下,截取分成两个订单发给打印机打印 |
| 失败 | 1002 | 打印机编号和用户不匹配. | {"msg":"\u9a8c\u8bc1\u5931\u8d25 : \u6253\u5370\u673a\u7f16\u53f7\u548c\u7528\u6237\u4e0d\u5339\u914d.","ret":1002,"data":null,"serverExecutedTime":3} | 验证失败 : 打印机编号和用户不匹配 | 打印机编号没有绑定在当前飞鹅云账号,请核对当前编号绑定情况,填写正确的编号 |
删除打印机接口
| 状态 | 返回码 | 返回的JSON | 编码解析 | 解决办法 | |
|---|---|---|---|---|---|
| 失败 | -2 | 打印机编号为空 | {"msg":"\u53c2\u6570\u9519\u8bef : \u53c2\u6570\u503c\u4e0d\u80fd\u4f20\u7a7a\u5b57\u7b26\uff0c\"\"\u3001\"null\"\u3001\"undefined\".","ret":-2,"data":null,"serverExecutedTime":4} | 参数错误 : 参数值不能传空字符 | 检查接口代码,不传空值即可 |
| 成功 | 0 | 正确删除 | {"msg":"ok","ret":0,"data":{"ok":["123456789\u6210\u529f"],"no":[]},"serverExecutedTime":4} | 成功 | |
| 失败 | 0 | 打印机编号错误 | {"msg":"ok","ret":0,"data":{"ok":[],"no":["123456789\u7528\u6237UID\u4e0d\u5339\u914d"]},"serverExecutedTime":9} | 用户UID不匹配 | 打印机编号没有绑定在当前飞鹅云账号,请核对当前编号绑定情况,填写正确的编号 |
| 失败 | 0 | 打印机编号不合法 | {"msg":"ok","ret":0,"data":{"ok":[],"no":["1234567890000000\u6253\u5370\u673a\u4e0d\u5b58\u5728"]},"serverExecutedTime":3} | 验证失败 : 打印机编号不合法 | 检查接口代码,填写正确的打印机编号即可 |
修改打印机信息接口
| 状态 | 返回码 | 返回的JSON | 编码解析 | 解决办法 | |
|---|---|---|---|---|---|
| 失败 | -2 | 打印机编号为空 | {"msg":"\u53c2\u6570\u9519\u8bef : \u53c2\u6570\u503c\u4e0d\u80fd\u4f20\u7a7a\u5b57\u7b26\uff0c\"\"\u3001\"null\"\u3001\"undefined\".","ret":-2,"data":null,"serverExecutedTime":1} | 参数错误 : 参数值不能传空字符 | 检查接口代码,不传空值即可 |
| 成功 | 0 | 成功修改 | {"msg":"ok","ret":0,"data":true,"serverExecutedTime":3} | 成功 | |
| 失败 | 1001 | 打印机编号不合法 | {"msg":"\u9a8c\u8bc1\u5931\u8d25 : \u6253\u5370\u673a\u7f16\u53f7\u4e0d\u5408\u6cd5\u3002","ret":1001,"data":null,"serverExecutedTime":4} | 验证失败 : 打印机编号不合法 | 检查接口代码,填写正确的打印机编号即可 |
| 失败 | 1002 | 打印机编号和用户不匹配 | {"msg":"\u9a8c\u8bc1\u5931\u8d25 : \u6253\u5370\u673a\u7f16\u53f7\u548c\u7528\u6237\u4e0d\u5339\u914d.","ret":1002,"data":null,"serverExecutedTime":4} | 验证失败 : 打印机编号和用户不匹配 | 打印机编号没有绑定在当前飞鹅云账号,请核对当前编号绑定情况,填写正确的编号 |
清空待打印队列接口
| 状态 | 返回码 | 返回的JSON | 编码解析 | 解决办法 | |
|---|---|---|---|---|---|
| 失败 | -2 | 参数错误 : 该帐号未注册 | {"msg":"\u53c2\u6570\u9519\u8bef : \u8be5\u5e10\u53f7\u672a\u6ce8\u518c.","ret":-2,"data":null,"serverExecutedTime":22} | 参数错误 : 该帐号未注册 | 检查接口代码,不传空值即可 |
| 成功 | 0 | 正确清空 | {"msg":"ok","ret":0,"data":true,"serverExecutedTime":4} | 成功 | |
| 失败 | 1002 | 打印机编号错误 | {"msg":"\u9a8c\u8bc1\u5931\u8d25 : \u6ca1\u6709\u627e\u5230\u8be5\u6253\u5370\u673a\u7684\u4fe1\u606f.","ret":1002,"data":null,"serverExecutedTime":4} | 验证失败 : 没有找到该打印机的信息 | 检查接口代码,填写正确的打印机编号即可 |
查询订单是否打印成功接口
| 状态 | 返回码 | 返回的JSON | 编码解析 | |
|---|---|---|---|---|
| 已打印 | 0 | 已打印 | {"msg":"ok","ret":0,"data":true,"serverExecutedTime":3} | 已打印 |
| 未打印 | 0 | 未打印 | {"msg":"ok","ret":0,"data":false,"serverExecutedTime":3} | 未打印 |
查询打印机某天的订单统计数接口
| 状态 | 返回码 | 返回的JSON | 编码解析 | 解决办法 | |
|---|---|---|---|---|---|
| 失败 | -2 | 输入日期为空 | {"msg":"\u53c2\u6570\u9519\u8bef : \u53c2\u6570\u503c\u4e0d\u80fd\u4f20\u7a7a\u5b57\u7b26\uff0c\"\"\u3001\"null\"\u3001\"undefined\".","ret":-2,"data":null,"serverExecutedTime":1} | 参数错误 : 参数值不能传空字符 | 检查接口代码,不传空值即可 |
| 成功 | 0 | print已打印数量 waiting未打印数量 |
{"msg":"ok","ret":0,"data":{"print":6,"waiting":1},"serverExecutedTime":9} | print已打印数量 waiting未打印数量 |
|
| 失败 | 1001 | 找不到该日期数据 | {"msg":"\u53c2\u6570\u9519\u8bef : \u627e\u4e0d\u5230\u8be5\u65e5\u671f\u6570\u636e.","ret":1001,"data":null,"serverExecutedTime":6} | 参数错误 : 找不到该日期数据 | 检查接口代码,传输正确的日期即可 |
查询打印机状态接口
| 状态 | 返回码 | 返回的JSON | 编码解析 | |
|---|---|---|---|---|
| 在线 | 0 | 在线 | {"msg":"ok","ret":0,"data":"\u5728\u7ebf\uff0c\u5de5\u4f5c\u72b6\u6001\u6b63\u5e38\u3002","serverExecutedTime":3} | 在线,工作状态正常 |
| 离线 | 0 | 离线 | {"msg":"ok","ret":0,"data":"\u79bb\u7ebf\u3002","serverExecutedTime":3} | 离线 |
| 在线,纸异常 | 0 | 在线,纸异常 | {"msg":"ok","ret":0,"data":"\u5728\u7ebf\uff0c\u5de5\u4f5c\u72b6\u6001\u4e0d\u6b63\u5e38\u3002","serverExecutedTime":13} | 在线,工作状态不正常 |
