在apigee上部署OpenAPI规范。

Question

我们有300多个REST APIs，我们正在创建OpenAPI 3 (yaml)规范，并最终部署在apigee中。因为api的数量有点多，有没有任何自动验证和规范并在apigee中部署它们的方法，或者类似项目的其他最佳实践。

Answer 1

根据我的经验，可以考虑的方案不多。

1. 所有300多个API不需要作为一个API代理来托管，所以在代理级别上打破你的API规范。
2. 当对API规范进行任何更改时，一个好的方法是将审查过程与APIGEE分开，并使用传统的GIT模型。在GitBitbucket中为API规范创建一个repo。在这里，API设计者可以对API规范进行修改，并提交一个PR。在此，你可以有验证测试的swagger是可用的开源，将检查任何验证。一旦PR从变化中通过，并由所有的审查员批准，那么你将确信API规范的质量和格式。
3. 下一步可以将API规范部署到APIGEE中，可以使用Jenkins CICD自动完成。我个人还没有做过这部分，但这是可以做到的。谢谢，Alok