参考
https://www.showdoc.com.cn/runapi/30775
1、介绍
runapi是一个以接口为核心的开发测试工具（功能上类似postman）。目前有客户端版(推荐，支持win/mac/linux全平台）和在线精简版 ，包含接口测试/自动流程测试/Mock数据/项目协作等功能。
它和showdoc( https://www.showdoc.com.cn/help )相辅相成：showdoc以文档为核心，侧重文档编写和知识资料沉淀。而runapi则以接口为核心，包含接口测试、管理、Mock数据、自动化流程测试等一系列功能。同时它将自动生成文档到showdoc，无须再手动编写文档，释放生产力；共用showdoc的团队管理机制，很好地实现接口的自动化和多人协作。相信使用 showdoc + runapi 这两个工具组合，能够极大地提高IT团队的效率。
2、客户端版本
3、数据说明
runapi的数据可以生成markdown格式，但不可逆，markdown数据很难再转换回来runapi。所以它无法跟showdoc原有数据互相转换。只是它们可以共用文档浏览/团队协作等功能。同时runapi生成的文档只能在runapi上编辑，不能在showdoc上编辑。后面如果要做数据共用，可能需要对showdoc编写格式有一定的规范约束，这个后面再探索下。
4、在线精简版
在线精简版和客户端版差别很大，它只包含简单的接口请求以及生成markdown代码，只用作简单调试，无法自动生成文档到showdoc以及无法使用项目团队协作功能等。访问地址： http://runapi.showdoc.cc
5、本地/局域网
如果你是使用runapi客户端 （ https://www.showdoc.cc/runapi ），则会自动跨域，可以请求本地和局域网的接口，不需要用户额外操作。但如果你是使用在线精简版（ http://runapi.showdoc.cc ）则需要在API的服务器上设置允许跨域。在服务器返回API结果的时候，也顺便返回三个允许跨域的http header，其结构如下：
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials : true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Connection, User-Agent, Cookie
至于服务器如何操作http header ，各语言有各语言的实现。php的实现如下所示：
header("Access-Control-Allow-Origin: *");
header("Access-Control-Allow-Credentials : true");
header("Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Connection, User-Agent, Cookie");
其他的语言的实现也同理。你可以上网搜索下如何更改http header的代码，此处不再一一列举。注意，项目上生产环境前，请把以上代码注释掉，以免暴露安全隐患。
|