场景说明
当前阿里云对外开放1万+个独立OpenAPI,且正处于加速增长的趋势。随着云产品需求迭代、产品设计变更、历史缺陷完善等因素,API接口设计无法始终如一,更改在所难免;而对于开发者来说,不同类型的API变更对于自身环境的影响也是大相径庭,不同人员角色更对不同程度的API变更有特殊的关注侧重点。
针对OpenAPI的变更与发布,如何详实、精准面向社区,并且更优雅向开发者展示变更内容,我们初次提出了OpenAPI变更日志功能来解决以上问题。
产品能力介绍
1. 一站式「最新变更」
根据实际业务需求,针对性筛选云产品、变更类型,跟踪具体OpenAPI,助力一站式高效找到想要的信息。所有变更类型覆盖4大类(参数变更、错误码变更、API变更、deprecated标记)中的11种变更详情。
同时支持高效预览,通过统一的变更规范,格式化、结构化透出变更概要,帮助用户高效捕捉信息,选择性查看变更集详情。
变更筛选项 变更集详情
2.云产品OpenAPI变更集
与变更主页的前后联动,由简到繁,详细展示包括但不限于参数变更diff细节、错误码变更前后对比等信息。符合开发者阅读与操作习惯。
3. OpenAPI变更消息订阅
支持变更信息一键订阅,通过webhook实时触达最新消息。支持选择云产品、API版本、联系方式,变更及时同步,用户按需高效做出响应。
4.OpenAPI元数据下载与订阅
支持多场景集成方案,满足开发者想象。一份JSON文件包括每个OpenAPI自身的全量信息,包含版本、API定义、出入参、返回码、错误码等信息。
更多功能,敬请期待
更多的消息订阅方式和OpenAPI 变更类型即将支持,快来体验阿里云 OpenAPI 最新变更 吧。点击订阅:https://next.api.aliyun.com/latest-changes
您在使用 OpenAPI 开发者门户中,碰到的任何问题和意见,都可添加门户钉钉值班群(31875811),OpenAPI 体验团队全员技术小哥将每周 7x24 小时为开发者们贴心服务。