本文整理了金蝶云·星辰小微生态产品的常见问题及其解答,包括接口熔断限流、API报错处理、单据操作、推送支持、错误码处理、灰度环境说明、自定义字段保存、云进销存会计错误处理、curl工具解释、API授权购买流程、应用中心问题及应用启用错误处理等,旨在帮助用户解决使用中的疑惑。
Hello,小伙伴们,大家好,
本篇文章为大家整理了金蝶云·星辰小微生态产品的常见问题,内容主要源自云之家小微产品开放平台交流群小伙伴的日常提问的总结,希望对大家有所帮助,如有疑惑欢迎评论区留言讨论。
问1-为什么接口会被熔断或限流?
答:目前星辰限流接口措施分为针对单个接口和针对单个账套的。如:所有伙伴每秒调用库存列表接口不超过150次,针对账套一段时间内调用所有接口的总次数。
问2-为什么请求API1.0接口报错为“no Route matched with those values;参数错误:不能获取租户ID,请联系系统管理员”
答:这个错误一般是因为header头有误,access_token,accountGroups不对或者不一致导致。请检查header头或者重新请求账套匹配。
问3-金蝶云·星辰API1.0接口如何下推单据?
问4-金蝶云·星辰API1.0接口如何审核、删除和反审核?
答:请点击链接查看审核、删除和反审核接口
https://open.jdy.com/#/files/api/detail?index=2&categrayId=1f51c576013945e2af68ef15d4245a48&id=277b35b087664372ac27a0dc53534fa1
问5-星辰是否支持主动推送?
答:星辰支持主动推送。消息订阅操作指南:https://open.jdy.com/#/files/api/detail?index=3&categrayId=5403e0fd6a5811eda819b759130d6d33&id=8f225a2c7c7e11ed8dde6f805900f65c
问6-如何处理接口返回519的情况?
答:519返回有具体的错误信息,请尽量用postman进行问题复现,如问题未解决请在开发者社区发帖提问,提问路径:开发者社区-问答-提问题-选择话题为小微产品开发。请勿直接贴出账号信息,数据信息,以及token的隐私问题,我们会有工作人员私信联系您。请注意查收私信信息。
问7-如何处理业务接口报错?
答:请仔细参考接口文档。请尽量用postman进行问题复现,如问题未解决请在开发者社区发帖提问,提问路径:开发者社区-问答-提问题-选择话题为小微产品开发。请勿直接贴出账号信息,数据信息,以及token的隐私问题,我们会有工作人员私信联系您。请注意查收私信信息。
问8-什么是灰度环境?正式环境和灰度环境有什么区别?
答:灰度发布(又名金丝雀发布)是指在黑与白之间,能够平滑过渡的一种发布方式。在其上可以进行A/B testing,即让一部分用户继续用产品特性A,一部分用户开始用产品特性B,如果用户对B没有什么反对意见,那么逐步扩大范围,把所有用户都迁移到B上面来。灰度发布可以保证整体系统的稳定,在初始灰度的时候就可以发现、调整问题,以保证其影响度。
正式环境和灰度环境的区别在于:代码的新功能优先更新到灰度环境,运行一段时间后再同步到全部环境。
问9-金蝶云·星辰如何保存自定义字段?
答:需要先查询自定义字段名称,然后在保存接口上带上。自定义字段使用指南:https://open.jdy.com/#/files/api/detail?index=2&categrayId=3cc8ee9a663e11eda5c84b5d383a2b93&id=76567ff2a06311edaa4b3d71bf0fce53
问10-如何处理云进销存和云会计提示502错误?
答:处理方法:需要header头加入X-GW-Router-Addr 参数。X-GW-Router-Addr为对应精斗云服务账套接口返回的domain。
问11-什么是curl?
答:curl是一个利用URL语法在命令行下工作的文件传输工具,可以使用工具进行curl的导出,图展示为postman(高版本)导出curl的方式。
问12-企业内部应用如何购买API授权服务?
答:请参考[购买API授权服务](https://open.jdy.com/#/files/api/detail?index=3&categrayId=5403e0fd6a5811eda819b759130d6d33&id=af16dda37c8111ed8ddec58e63f6c445)流程。
问13-是否可以一次性购买多个API授权服务?
答:暂不支持。
问14-为什么在应用中心看不到购买的应用?
答:步骤一、请确认当前账号是否为服务管理员(购买金蝶云星辰、精斗云云进销存或精斗云云会计的人),如果不是,请联系服务管理员对该应用进行启用和用户管理操作,操作后,若被授权的企业用户在应用中心仍看不到该应用,请前往步骤二;
步骤二、请确认当前企业是否在工作台认证,如果未认证,请前往工作台完成企业认证(链接待提供),认证后,若应用中心依然看不到购买的应用,请前往步骤三;
步骤三、请确认购买生态应用的企业与购买金蝶云星辰、精斗云云进销存或精斗云云会计的企业是否一致,如果不一致,请走生态产品退款流程,重新下单购买。
问15-启用应用时,提示:服务商没有回传第三方实例,请联系服务商管理员处理。
答:【解决方案】
1、修改弹框提示:服务商未开通该应用,请联系[生态应用售后联系人]处理。
2、生态服务部驱动ISV伙伴实现生态集成产品免登。
问16-请求接口提示"X-Api-Signature无效"。
答:1、可以直接使用自动添加X-Api-Signature签名的https请求[sdk](https://open.jdy.com/#/files/api/detail?id=558f1245958211edaa4b0940356e4cc9&noside=true)。
2、可参考[X-Api-Signature加密规则](https://open.jdy.com/#/files/api/detail?id=8e30d0c5750a11edb791770952761e03&noside=true)进行加密,若发现代码加密出来的签名串仍然无法通过校验,可以使用签名原文使用[HMAC](http://www.metools.info/code/c25.html)、[Base64](https://c.runoob.com/front-end/693/))进行对比是否一致。
实操干货 金蝶云·星辰小微生态产品常见问题16问.docx(161.86KB)
推荐阅读