尊敬的开发者：
为优化服务架构、提升接口性能与可维护性，平台将对所有业务接口的请求方式进行升级改造。自本公告发布之日起，我们将逐步推进 “业务接口共用请求URL”改为“分流至对应接口独立URL” 的调整。此次改造旨在为您提供更稳定、高效、透明的接口服务，并支持未来更灵活的功能扩展。
一、改造背景与目标
当前业务接口通过统一入口URL分发请求，随着业务复杂度提升，该方式在性能监控、问题定位、版本管理等方面存在局限。调整为接口与URL一一对应的模式后，将实现：
更清晰的接口职责分离，便于开发者理解与调用；
更精准的请求监控与故障排查，提升服务稳定性；
更灵活的接口版本管理与迭代，降低升级影响。
二、具体变更内容
变更范围：涉及的业务接口列表及新旧URL映射关系，请详见 七、接口改造对照表。
变更方式：
原共用URL将继续保留至 [截止日期2026年08月01日]，但后续将不再接收新增功能更新。
新URL即日起生效，建议开发者尽快完成迁移测试。
接口协议与参数：接口的请求/响应协议、参数定义、鉴权方式等保持不变，仅URL路径调整。
三、开发者改造指南
请您按以下步骤尽快完成适配：
查阅对照表：确认您调用的接口是否在改造范围内，并获取新URL。
测试环境验证：在测试环境调用新URL，确保功能与数据正常。
逐步切换流量：建议先灰度切换部分请求，验证稳定后逐步迁移至新URL。
关注监控与日志：切换后请关注请求成功率、延迟等指标，如有异常及时回退并反馈。
四、时间安排
公告日期：2026年01月15日
新URL生效日期：2026年01月15日
旧URL停用日期：2026年07月01日 我司将在停用旧URL前30天会再次提醒
旧URL完全下线日期：2026年08月01日
五、支持与保障
文档与工具：更新后的接口文档已发布至开发者中心，同时关联SDK已更新等支持。
答疑支持：如有问题，请前往企业微信：飞鹅技术支持 咨询或反馈。
监控与预警：我们将密切监控迁移期间的服务状态，如有异常将第一时间通知。
六、注意事项
请务必在旧URL停用前完成迁移，避免服务中断。
建议采用配置化方式管理URL，便于后续灵活调整。
如您在使用中遇到任何兼容性问题，请及时联系我们协同解决。
七、 接口改造对照表
1. 中国站接口：
| 接口名 |
接口简介 |
旧 - 请求URL |
新 - 请求URL |
| Open_printerAddlist |
批量添加设备 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/printerAddlist |
| Open_printMsg |
打印订单 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/printMsg |
| Open_printLabelMsg |
标签机打印订单 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/printLabelMsg |
| Open_printWmOrder |
外卖订单模板打印 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/printWmOrder |
| Open_printerDelList |
删除批量设备 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/printerDelList |
| Open_printerEdit |
修改设备信息 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/printerEdit |
| Open_delPrinterSqs |
清空待打印队列 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/delPrinterSqs |
| Open_queryOrderState |
查询订单是否打印成功 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/queryOrderState |
| Open_queryOrderInfoByDate |
查询指定设备某天的订单统计数 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/queryOrderInfoByDate |
| Open_queryPrinterStatus |
获取某台设备状态 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/queryPrinterStatus |
| Open_printerInfo |
获取某台设备信息 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/printerInfo |
| Open_printerSetScanSwitch |
设置设备扫码回调 |
https://api.feieyun.cn/Api/Open/ |
https://api.feieyun.cn/Api/Open/printerSetScanSwitch |
2. 亚太站接口：
| apiname |
Brief Introduction |
Request URL - Old |
Request URL - New |
| Open_printerAddlist |
Add printers in batches |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/printerAddlist |
| Open_printMsg |
Print order |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/printMsg |
| Open_printLabelMsg |
Label machine printing order |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/printLabelMsg |
| Open_printerDelList |
Delete batch printers |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/printerDelList |
| Open_printerEdit |
Modify printer information |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/printerEdit |
| Open_delPrinterSqs |
Empty the queue to be printed |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/delPrinterSqs |
| Open_queryOrderState |
Query whether the order is printed successfully |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/queryOrderState |
| Open_queryOrderInfoByDate |
Query the order statistics of the specified printer for a certain day |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/queryOrderInfoByDate |
| Open_queryPrinterStatus |
Get the status of a printer |
https://api.jp.feieyun.com/Api/Open/ |
https://api.jp.feieyun.com/Api/Open/queryPrinterStatus |
3. 欧洲站接口：
| apiname |
Brief Introduction |
Request URL - Old |
Request URL - New |
| Open_printerAddlist |
Add printers in batches |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/printerAddlist |
| Open_printMsg |
Print order |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/printMsg |
| Open_printLabelMsg |
Label machine printing orde |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/printLabelMsg |
| Open_printerDelList |
Delete batch printers |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/printerDelList |
| Open_printerEdit |
Modify printer information |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/printerEdit |
| Open_delPrinterSqs |
Empty the queue to be printed |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/delPrinterSqs |
| Open_queryOrderState |
Query whether the order is printed successfully |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/queryOrderState |
| Open_queryOrderInfoByDate |
Query the order statistics of the specified printer for a certain day |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/queryOrderInfoByDate |
| Open_queryPrinterStatus |
Get the status of a printer |
https://api.de.feieyun.com/Api/Open/ |
https://api.de.feieyun.com/Api/Open/queryPrinterStatus |
感谢您一直以来的支持与信任。我们将持续优化平台服务，与您共同构建更可靠的开发者生态。
飞鹅云开放平台产品团队
2026年01月15日
