OpenAPI使用规范

一、开放平台公告

开放平台接口会进行正常迭代，对于打破兼容性的情况，我们会通过发公告的方式告知使用者。

请关注公告： https://community.yonyou.com/forum-126-1.html

二、废弃接口

对于打废弃标签的接口，将不再接受新的开发需求，已经授权使用的开发者接口仍可继续使用。 新客户将无法使用此类接口。建议调整为新版本接口。

三、队列

对于定时同步数据的情况，接口使用方需通过队列根据开放平台接口限流策略，平稳调用接口。 对于循环调用触发限流的情况，不提供调整限流的能力。

四、补偿

异构系统融合对接，接口使用方需建立补偿机制，应对超时、服务波动等引发的数据同步异常。

五、幂等

开放平台部分接口提供幂等能力，防止重复提交生成重复数据。 幂等key生成策略建议：https://community.yonyou.com/forum.php?mod=viewthread&tid=221075

六、异常调用

对于产生大量异常调用的使用方，生态部门支持人员会优先选择联系使用方确定情况。 对于无法联系且给开放平台服务造成严重影响的使用方，将会对其采取限流处理。在配合调整后恢复正常限流。

七、缓存策略

获取租户所在数据中心域名、获取token等接口，建议做缓存处理。

建议缓存时间：

1、获取租户所在数据中心域名 可长久缓存（1个月）

2、to