本节我们插播一条:接口文档导入。
在项目中点击接口文档导入,可以打开接口文档解析页面。
众所周知,接口文档各个公司都不同,而且各个模块/组/开发同学 的写法也不同。所以我们的解析算法不可能准确达到100% 或者说 不用维护了。那么就一定是一个可持续优化的过程。在这个过程中,难免出现解析失败的情况,所以我们要在交互层加入一层,来让用户自己确认解析的结果并做检查和修改。然后让用户自己去点击导入按钮,这样在后续出现问题背锅的时候,我们可以用这层来甩。^_^
首先点击这里
进入页面的这个过程中,平台会先去解析所有接口目录。我们分三层,各公司不一样。
当我们选了最终接口的时候,会触发俩件事:
一件事是解析这个接口,提取出名称/描述/method/请求体/url/host/编码格式等。
另一件事是要打开这个接口文档该接口的页面展示在左侧iframe,好让用户自己根据文档来手动修补右侧的提取结果。
最终确认没问题就点击右上角的导入此项目按钮,即可把接口成功导入项目了。
怎么样 是不是很赞?