RunApi

参考

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、客户端版本

• Windows版 - 点击下载
• Mac版 - 点击下载
• Linux版 - 点击下载

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的实现如下所示：

// 允许 runapi.showdoc.cc 发起的跨域请求
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的代码，此处不再一一列举。注意，项目上生产环境前，请把以上代码注释掉，以免暴露安全隐患。