OpenAPI新特性汇总

本文章用于OpenAPI（开放平台）的新特性发布通知，请大家定期关注

苍穹补丁下载路径：https://download.kdcloud.com/

2024-06-13   BOS_V6.0.13

    1. 【功能优化】：OpenAPI请求报文出入参最大长度限制20M(文件流50M)，防止因报文过长而导致请求超时。

2024-05-30   BOS_V6.0.12

    1. 【功能优化】：保存操作API支持用户定义请求参数默认值。

    2. 【功能优化】：OpenAPI防重复请求优化，增加数据库防重控制机制。

    3. 【问题修复】：解决统计看板中折线图，在切换数据中心时的数据残留问题。

2024-05-16   BOS_V6.0.11

    1. 【新功能】：OpenAPI新增摘要认证调试界面，方便用户使用摘要认证时生成和校验签名。

2024-04-25   BOS_V6.0.10

    1. 【功能优化】：OpenAPI详情界面和API文档展示完整URL地址（智能拼接），提升用户体验 2. 功能优化：优化API文档导出功能，支持批量导出到1个PDF文件。

    2. 【功能优化】：优化API文档导出功能，支持将多个API文档合并导出到1个PDF文件中。

2024-03-28   BOS_V6.0.8

    1. 【新功能】：新增慢接口统计功能，默认统计前一天响应时间超过10s的慢接口记录，帮助用户实时监控整体接口性能。

        https://vip.kingdee.com/article/561129544887976960

    2. 【新功能】：新增预警配置功能，支持配置消息渠道和消息模板，当出现慢接口等异常情况时，及时进行消息预警。

         https://vip.kingdee.com/article/561135209848877312

    3. 【新功能】：新增预警日志功能，记录API消息预警日志，帮助用户查看预警消息的推送情况。

         https://vip.kingdee.com/article/561139114830087168

    4. 【新功能】：API列表左树新增自定义分组模式，支持按不同的分组维度，个性化管理不同云、应用下的API。

        https://vip.kingdee.com/article/558285650663628544

    5. 【功能优化】：保存操作API支持自动提交并审核。

        https://vip.kingdee.com/article/563359453035097856

    6.【功能优化】：API请求头示例参数允许用户自定义，并自动同步到API文档。

    7.【功能优化】：扩展插件功能优化，序列化插件提供新的方法获取全部参数。

         https://vip.kingdee.com/article/512929770493846784

    8.【功能优化】：扩展插件功能优化，查询操作API插件新增自定义排序功能。

         https://vip.kingdee.com/article/512935531689404928

    9. 【功能优化】：增强API日志打印安全性，默认脱敏access_token、jwt、openApiSign等令牌字段。

    10. 【功能优化】：API日志优化，记录接口限流时的monitor日志，方便用户定位问题。

    11. 【功能优化】：API 防重复请求功能优化，通过接口保存数据时锁定业务对象，避免高并发场景下接口重复保存数据。

    12.【功能优化】：请求参数协议支持优化，增加报文格式text/xml的内容检测，并进行正确的报文处理。

    13.【功能优化】：当使用基本认证时，请求URL中的openApiSign值支持使用转义符，如=转%3D。

    14.【问题修复】：修复了特殊场景下，当弹性域中的基础资料没有名称属性时，使用查询操作API查询弹性域报错的问题。

    15. 【问题修复】：修复了点击云更新同步标准接口时，系统提示“认证不通过”的问题。

2023-10-24   BOS_V6.0.1

    1.  云迁移：【开放平台】改名为【OpenAPI】，菜单迁移到【开放服务云】。

    2. 新增功能：新增【增强型Token认证】模式，管理Token的全生命周期，支持获取、刷新、验证及失效请求令牌。

        https://vip.kingdee.com/article/489812471528707840?productLineId=29&isKnowledge=2

    3. 功能优化：操作API 适配开发平台【单据】字段类型。

    4. 功能优化：导出PDF文档中请求地址由URI改为完整URL，自动拼接当前环境地址和kapi段。

    5. 功能优化：保存操作API新增自定义操作参数：“rmStatusControl”，是否移除单据状态控制，手工新增，当值为true时，可跳过已审核单据和基础资料不允许修改的校验，直接更新已审核的单据或基础资料。

    6. 功能优化：保存操作API新增操作参数：“is_importinit”，是否触发引入方法。

    7. 功能优化：保存操作API新增操作参数："mutex_ignore_validation"，保存时是否忽略网络互斥。

    8. 功能优化：第三方应用列表增加【更多】按钮，支持查看当前账套信息。

    9. 功能优化：第三方应用增加【应用联系人】字段，可维护外部系统的对接人信息。

    10. 功能优化：第三方应用增加【获取Token示例】按钮，可快速查看获取Token报文示例。

    11. 问题修复：操作API优化日期字段合规性校验，不允许超出数据库存储范围，如日期小于1900-01-01。

2023-08-20   BOS_V5.0.026

    1. 问题修复：修复了操作API如批量提交、删除审核等接口，请求参数的Array字段示例错误问题。

    2. 问题修复：优化了查询操作API使用体验，当检查到PageSize查询页码过大时，提示报错；当检查到PageNo超过int 最大值时，提示报错。

    3. 体验优化：增强查询权限控制，操作API新增时，若操作方式为查询，默认打开开关“启用查询权限控制”。

2023-06-30   BOS_V5.0.023

    1. 体验优化：优化了第三方应用页面交互，将认证方式、访问控制和加密策略展示成卡片形式，提升用户体验。

      https://vip.kingdee.com/article/464754959607876608

    2. 体验优化：优化了查询操作API文档的展示效果，在返回参数中增加公共返回参数，提升文档可用性。

    3. 功能优化：优化了第三方应用访问控制，允许用户配置IP黑名单，提升系统安全性。

    4. 功能优化：自定义API支持将参数值以路径变量形式直接拼接到请求url。

    5. 功能优化：新增操作API支持的表单模型，支持日志表单和余额模型，降低API开发门槛。

       https://vip.kingdee.com/article/464748428388700416

    6. 问题修复：修正API文档中公共返回参数示例，调用成功时错误码返回"0"。

    7. 问题修复：非简体中文语言环境下，API管理列表和API文档左树节点支持展示默认语言。

2023-05-21   BOS_V5.0.021

    1. 新增功能：API列表支持导出Swagger文档，遵循最新的Swagger3.0规范。

       https://vip.kingdee.com/article/454600313165665024

    2. 功能优化：API 国际化多语言功能优化。

       https://vip.kingdee.com/article/453557180919091968

2023-04-27   BOS_V5.0.020

     1. 功能优化：操作API支持更新业务对象分录时，不校验分录id。保存操作API增加操作参数：is_checkentryid，默认为true，若设为false，则更新数据时，不强制校验分录id在系统中是否存在。

    2. 体验优化：第三方应用维护页面，不强制禁用状态才允许保存，增加弹窗提示。

    3. 问题修复：解决脚本API，在导出PDF时，请求参数出现乱序和丢失参数问题。

    4. 问题修复：解决ALL方式的SevletAPI，请求文档中的请求方式错误问题。

2023-03-31   BOS_V5.0.018

   1. 新增功能： 操作API支持扩展插件，对请求出入参进行序列化处理。

    https://vip.kingdee.com/article/512929770493846784

    https://vip.kingdee.com/article/512935531689404928

   2. 新增功能： API配置页面，新增配置项【防止重复请求】，相同请求参数的请求在10秒内只能调用一次。

   3. 功能优化：API日志过期自动清理，保留时间改为默认30天，最长90天。

       https://vip.kingdee.com/article/418791066016674816

   4. 功能优化：Webservice接口支持一键生成WSDL文件。

   5. 体验优化：API配置界面，不强制禁用状态才允许保存，增加弹窗提示。

   6. 体验优化：测试弹窗可以改为分屏模式，支持放大缩小。

   7. 问题修复：解决部分自定义API返回参数示例与实际返回不符问题。

2022-12-15   BOS_V5.0.014

   1. 新增功能：API Servlet扩展，支持自定义处理Servlet，解决复杂业务场景。

     https://vip.kingdee.com/article/407938727957357824

   2. 新增功能：查询、保存操作API接入隐私中心，支持对敏感字段和日志脱敏。

    https://vip.kingdee.com/article/408204299592721152

   3. 功能优化：OpenAPI报文格式context-type支持text/xml。

   4. 问题修复：解决保存操作接口，特殊基础资料（如业务员、银行账户等）编码传空值时报错问题。

2022-12-15   BOS_V5.0.012

   1. 新增功能：支持用户配置查询操作API时，查询条件中常量参数支持函数脚本。

   2. 功能优化：新增保存操作API参数，可配置是否执行引入方法。

   https://vip.kingdee.com/article/376380062704500992

   3. 功能优化：新增配置项，在API详情界面，用户可配置调用API接口是否需第三方应用授权、匿名访问等。

   4. 功能优化：支持为保存操作API配置最大处理数据行，避免接口超时问题。

   5. 功能优化：限流策略支持匿名访问维度。

   6. 功能优化：支持开发操作API时，请求参数和返回参数中选到分录的关联关系实体。

   7.  新增接口：新增开放平台标准单据示例接口，作为用户开发操作API时参考模板。

2022-11-17   BOS_V5.0.011

   1.  交互优化：开放平台菜单目录调整。

   2. 交互优化：开放平台第三方应用详情UE交互优化。

   3. 新增功能：API管理列表增加【云更新】按钮，支持从云端同步最新的API资源。

   4. API&SDK：新增 500+ 标准OpenAPI接口和SDK文档，覆盖财务、供应链、制造、HR、流程等领域接口使用场景。

      开放门户：https://dev.kingdee.com/index/open

   5. API安全：第三方应用新增认证方式：签名认证，对接口数据加签，有效防篡改。

      https://vip.kingdee.com/article/383567026112739840

   6. API安全：第三方应用新增加密策略，调用接口时对数据加密。

   7. 问题修复：修复通过操作API更新数据时，基础资料id或编码传空时，未清除单据中基础资料字段且接口报错的问题。

   8. 问题修复：修复通过操作API保存数据时，若long类型字段如ID为一位数，则保存报错的问题。

   9. 问题修复：修复通过操作API保存数据时，若单据中某个基础资料存在多个分组中时（如销售员与销售组），保存报错的问题。

   10. 问题修复：修复通过操作API保存数据时，请求体中若存在long类型字段，且为一位数，则保存报错的问题。

2022-09-22   BOS_V5.0.009

   1.  新增功能：API管理列表支持导出并导入，帮助用户快速完成不同环境间的API数据的备份和迁移。

    https://vip.kingdee.com/article/347769782810858496

   2.  新增功能：开放平台API管理列表支持导出sql脚本。

   3. 新增功能：API文档样式优化，展示更清晰简洁的markdown文档。

   4. 新增功能：自定义API支持匿名访问，当MC参数 login_api_support_anonymous为true 时，自定义API详情界面展示匿名开关。

   5. 新增功能：API查询操作API 支持校验接口代理用户组织权限及数据规则，防止出现数据越权。

   6. 功能优化：操作API支持选择业务对象所有操作方式。

   7. 功能优化：API详情新增版本苍穹版本字段，默认展示当前接口适用的版本号。

   8. 功能优化：保存操作API，参数控制增加默认参数：完全覆盖分录OverrideEntry，当值为true时，更新保存会将原分录完全删除后再新增分录。

   9. 功能优化：查询操作API，当查询参数新增一行后，默认生成对应的查询条件。

   10. 功能优化：自定义API出参允许修改根节点，支持将root节点变更为其它如名称如response。

   11. 功能优化：自定义API支持model属性直接传参、通过注解声明请求头和错误代码。

    https://vip.kingdee.com/article/294499338318073088

   12. 功能优化：脚本API支持在脚步里面获取获取全部请求参数。

   13. 功能优化：脚本API资源引用资源优化，避免API资源间接循环引用。

   14. 问题修复：解决保存操作API，自定义操作参数无法直接保存的问题。

   15. 问题修复：保存操作API，日期字段格式缺陷处理，解决部分错误格式传入后依然可以传入成功的问题。

   16. 问题修复：解决查询操作API，当请求参数默认值为"*"时，导致的左括号与右括号不匹配问题。

   17. 问题修复：查询操作API查询条件中状态字段(status）比较方式支持“不等于”。

   18. 问题修复：解决部分场景下删除操作API调用失败后，返回参数外层message为null的问题。

   19. 问题修复：解决导出PDF接口文档时，API接口请求体示例结构缺少data域的问题。

   20. 问题修复：优化API日志记录，GET方式的查询接口的请求参数，展示请求地址中拼接的query参数。

   21. 问题修复：解决由于NGINX转发后字符集问题，导致中文参数在接收时出现乱码的问题。

2022-08-25   BOS_V5.0.007

1. 新增功能：API支持基于基本认证模式，一键生成接口回调地址。

       https://vip.kingdee.com/article/352773265946763776

   2. 功能优化：优化弹性域保存入参样式，支持按核算维度编码作为入参标识。

       https://vip.kingdee.com/article/352775732332438016

   3. 功能优化：优化PG库兼容问题，查询操作API支持按基础资料的内码进行过滤查询。

   4. 新增接口：提供API日志的API查询接口，用户可以分页导出大量日志以做审计。

   5. 新增接口：提供API查询接口，允许用户查询API列表。

   6. 新增接口：提供第三方应用查询接口，允许用户查询第三方应用列表和详情。

2022-08-11   BOS_V5.0.006

1. 问题修复：修复了API2.0保存接口，入参中long类型字段为空时，系统默认赋值 '0' 的问题。

   3. 问题修复：修复了日志取日志接口频繁调用微服务的问题。

   4. 问题修复：修复了API2.0分容器多节点部署时，调用接口提示 kd.bos.ext 相关问题。

   5. 功能优化：优化了API2.0接口返回错误message的展示。

2022-07-28   BOS_V5.0.005

1. 新增功能：API2.0维护界面添加字段，支持接口出参仅返回Data域内参数。

   https://vip.kingdee.com/article/342000610100428544

   
   

2. 新增功能：OpenAPI接口防止重复调用参数。

      https://vip.kingdee.com/article/341958917544263424

   3. 功能下架： API服务管理列表1.0 下架新增按钮，建议优先使用API2.0版本进行接口开发。

      https://vip.kingdee.com/article/341987772477117184

   4. 功能优化： 新增API1.0接口【升级】按钮，支持跳转到API2.0接口配置界面。

   5. 功能优化：API2.0接口、第三方应用在修改前必须先禁用，保障数据安全。

   6. 功能优化：API管理查询/保存/提交等操作API返回参数样式调整。

   7. 功能优化：API查询接口最大返回数量条数限制修改为