微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

apib 与 md 文件格式的问题

如何解决apib 与 md 文件格式的问题

我们开始使用 API BP,我们的 API 规范被编写并保存为 apib 文件。我们遇到的问题是,API Blueprint 站点上列出的所有工具(模拟服务器、swagger/postman 格式的转换器等)似乎都希望 API BP 文件采用 md 格式(降价),并且它们是无法处理 apib 文件

我们错过了什么。从我看到的 apib 文件与 md 文件不同。当然,如果 API BP 允许使用 apib 文件,那么必须使用可用的工具来支持吗?

此时看起来 API BP 是如此专有(即使是开源),以至于很难将其插入生态系统。您必须跳过篮球才能将其导入 Postman。可用于它的模拟服务器通常是过时/非常旧的代码,或者只能理解 Markdown。 Apiary 工具很棒,实际上可以理解 apib 文件,但它无法处理使用 include 语句的文件,因此您只能使用一个非常大的 apib 文件

API BP 很棒而且很容易编写规范并在后端吐出文档,但将其用于其他任何实用的东西似乎真的很痛苦。还是我错过了一些技巧?

我们真的需要帮助来调整我们使用 API BP 的方法,或者我们必须接受它不是适合我们的工具。

任何建议/指针将不胜感激。

谢谢

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。