稳定性保证应通过简单的 API 版本控制来解决。
这个主题不是关于文档的去向——而是关于 API 如何 被记录。缺失的是像 OpenAPI 这样的标准化、机器可读的格式。
这种缺失，加上缺乏版本控制，使得集成工作比应有的更困难、更脆弱。即使是已记录端点的基本 OpenAPI 模式也会非常有帮助。
3 个赞
稳定性保证应通过简单的 API 版本控制来解决。
这个主题不是关于文档的去向——而是关于 API 如何 被记录。缺失的是像 OpenAPI 这样的标准化、机器可读的格式。
这种缺失，加上缺乏版本控制，使得集成工作比应有的更困难、更脆弱。即使是已记录端点的基本 OpenAPI 模式也会非常有帮助。