【重要】开放平台常见问题合集

1. 如何获取到租户id和数据中心id？

• 参考：https://vip.kingdee.com/article/376304364408826368

2. 获取access_token报错问题合辑

• 参考：https://vip.kingdee.com/article/473850934762799616

3. 如何通过固定密钥调用OpenAPI？

• 参考：https://vip.kingdee.com/article/376375102319538688

4. 操作API可以修改已审核的单据或基础资料吗？

• 可以，参考：https://vip.kingdee.com/article/534676557541720576。

• 注意事项：缺省状态为暂存且带组织和控制策略的基础资料，在已审核状态下，默认就能通过接口修改；若不带组织和控制策略，默认是无法通过接口修改的，要结合OpenAPI操作参数"rmStatusControl"修改。
  

5. 操作API会触发哪些事件，什么时候触发值更新事件？

• 保存操作API默认不触发值更新事件，可通过勾选操作参数"firePropChanged"，将值设为true，进行触发。新增保存不支持，因为当批量新增数据时，若均触发值更新事件，极其影响系统性能，也可能导致某些值被重复覆盖。

• 参考：https://vip.kingdee.com/article/376385674549309952。

6. OpenAPI执行查询或保存大批量数据时，调用提示接口超时，应如何处理？

• 参考：https://vip.kingdee.com/article/375686586782388736

7. 调用API接口保存数据时，系统内生成重复数据，应该怎么处理？

• 参考：https://vip.kingdee.com/article/442690476898791424

8. API请求UTF8字符集乱码问题排查指南

• 参考：https://vip.kingdee.com/article/568740319076613376

9. 保存操作接口，希望保存自动提交并审核，如何处理？

• 参考：https://vip.kingdee.com/article/563359453035097856

10. OpenAPI引入单据或基础资料时，可以控制是否触发基础资料字段的权限校验吗？

• 路径：系统服务云 - 配置工具 - 系统参数，在公共参数中增加“引入数据时校验基础资料权限”配置。

• 不开启时，API引入只会校验基础资料的编码与名称是否存在。开启时，则会按照基础资料F7过滤条件，数据权限以及管控策略进行校验，是否满足条件。

  
  

11. 如何修改V2版本OpenAPI的返回参数格式？

• 参考：https://vip.kingdee.com/article/506782654352585472

12. 自定义API插件部署问题排查指南

• 参考：https://vip.kingdee.com/article/453492067302414336

  
  

13. 部分API服务，不需要注册第三方应用为什么也能直接访问？

• 需要确认这部分API服务是否开启了匿名访问，若开启了，则不需要经过第三方应用登录便能直接访问，该行为存在数据泄露风险，不推荐使用。

14. 打开API匿名访问开关后，匿名调用仍不生效？

• 当租户有多个数据中心时，如果默认数据中心和当前匿名API所在数据中心不一致，则必须在请求头或URL中添加参数accountId才能访问到指定数据中心的API服务。

15. 匿名访问调用POST请求，为什么提示error:oAuth认证失败，guest用户没有访问权限？

• 参考：https://vip.kingdee.com/article/376072785862352128

16. API1.0查询操作接口，返回的数据字段名和值是分开的，不是map的形式，开发要取某个字段的值怎么取呢？

• 在URL中添加参数：api.resulttype=json，此时支持返回标准json格式。V2版本标准查询接口，默认返回键值对。

17. API1.0保存操作接口，执行成功后，返回数据中输出的id与数据库中的id不相等是什么原因？

• 使用浏览器测试会让long类型的字段输出时存在精度丢失问题，建议使用postman客户端测试，新版本接口（v2）已优化处理，将long类型转换成string类型输出。

18. API1.0保存操作接口，希望保存自动提交，在请求体中添加了参数"forcedsubmit":"submit"，但仍不生效，是什么原因？

• 参数"forcedsubmit":"submit"不应放在data域里，而是要和data参数在同一级。

19. API1.0操作接口，会自动封装code、success、data之类的数据格式。若不想要这种格式应该怎么自定义返回信息？

• 参考：https://developer.kingdee.com/questions/302772500381668608。

  
  

20. API1.0自定义接口， 如何开发并注册java插件？

• 参考：https://vip.kingdee.com/article/154241666411380736

21. API1.0接口， 如何使用API插件？

• 使用说明：https://vip.kingdee.com/article/226288074844832512

• 踩坑指南：https://vip.kingdee.com/article/158244323199077376

22. API1.0自定义接口，调用时提示“实例化插件异常”？

• 原因1：系统正在升级中或容器异常，服务部署失败，建议检查环境是否正常。

• 原因2：自定义接口的插件路径不正确或缺失，建议检查插件路径。