runapi是一款以接口为核心的开发测试工具,目前有客户端版和在线精简版,包含接口测试/项目协作等功能,功能上类似一个简化版的postman。需要的朋友可下载体验!
和showdoc)相辅相成:showdoc以文档为核心,侧重文档编写和知识资料沉淀。而runapi则以接口为核心,包含接口测试、管理等一系列功能。同时它将自动生成文档到showdoc,以及共用showdoc的团队管理机制,很好地实现接口的自动化和多人协作。相信应用 showdoc + runapi 这两个工具组合,能够极大地提高IT团队的效率。
基本简介
如果你是应用runapi客户端,则会自动跨域,可以请求本地和局域网的接口,不需要用户额外操作。但如果你是应用在线精简版则需要在API的服务器上设置允许跨域。在服务器返回API结果的时候,也顺便返回三个允许跨域的httpheader,其结构如下:
Access-Control-Allow-Origin:*Access-Control-Allow-Credentials:trueAccess-Control-Allow-Headers:Origin,X-Requested-With,Content-Type,Accept,Connection,User-Agent,Cookie
至于服务器如何操作httpheader,各语言有各语言的实现。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");
其他的语言的实现也同理。你可以上网搜索下如何更改httpheader的代码,此处不再一一列举。注意,项目上生产环境前,请把以上代码注释掉,以免暴露安全隐患。
安装说明
下载软件,双击运行即可自动安装,需要注册账号
在线精简版
在线精简版和客户端版差别很大,它只包含简单的接口请求以及生成markdown代码,只用作简单调试,无法自动生成文档到showdoc以及无法应用项目团队协作功能等。
软件特色
开源文档工具showdoc推出调试接口的客户端(类似postman),支持windows和mac平台。
开发者在调试接口的同时即可自动生成文档到showdoc,简单好用易上手。
此外,showdoc是用Vue+ElementUI写的,而runapi主用React+AntDesign
RunApi特点
GET请求:点击Params,输入参数及value,可输入多个,即时显示在URL链接上
所以,GET请求的请求头与请求参数如在接口文档中无特别声明时,可以不填。
GET响应:右上角显示响应HTTP状态码、请求的耗时。
需特别注意的是注意区别HTTP状态码与响应正文中的状态码,只有HTTP状态码是200时
才代表这个接口请求是正确的,这个是HTTP协议定义的,而响应正文的状态码,是程序员自已定义的,可以是200,也可以定义为其它值,是为了让接口应用者去区分正常数据与异常数据。
软件功能
1、POST请求一:表单提交
设置了请求方法,请求URL,请求参数,但没有设置请求头。有一个要明确的点是,请求头中的Content-Type与请求参数的格式之间是有关联关系的。
Content-Type与请求参数的格式之间的关联
当选择x-www-form-urlencoded的参数方式后,postman自动的帮我们设置了Content-Type,所以不需要我们人工干预,这就是应用一款流行工具的好处,把一些基础点都帮我们处理了。
2、POST请求二:json提交
当我们选择了JSON(application/json)时,postman同样帮我们自动设置了Content-Type,可以自行的去查看Headers.
3、post请求三:xml提交
当我们选择了XML(text/xml)时,postman同样帮我们自动设置了Content-Type,可以自行的去查看Headers.
4、post请求四:自行设置Content-Type
HTTP的POST请求的参数,都是放在请求正文中的,只是根据Content-Type来判断请求正文的格式,那么我们同样可以在表单提交时,选择raw,然后自行设置Content-Type为application/x-www-form-urlencoded。
POST请求的参数
自行设置Content-Type
5、POST请求五:二进制文件提交
二进制文件提交
Body下,选择binary,在这里你可以发送视频、音频、文本等文件。
下载体验
下载仅供下载体验和测试学习,不得商用和正当使用。