`
amuropikin
  • 浏览: 41525 次
  • 性别: Icon_minigender_1
  • 来自: 广州
社区版块
存档分类

Swagger-UI 基于REST的API测试/文档类插件

阅读更多
现在多数的项目开发中,网站和移动端都需要进行数据交互和对接,这少不了使用REST编写API接口这种场景。例如我目前的工作,移动端交由了另一团队开发,不同开发小组之间就需要以规范和文档作为标准和协作基础。良好的文档可以让开发事半功倍,而作为又懒又要效率又能交代的码农,当然最希望一切自动化,或用小聪明来找到最适合的工具。

Swagger-UI简单而一目了然。它能够纯碎的基于html+javascript实现,只要稍微整合一下便能成为方便的API在线测试工具。项目的设计架构中一直提倡使用TDD(测试驱动)原则来开发,swagger-ui在这方面更是能提供很大帮助。

Swagger-UI更倾向于在线测试接口和数据,但其核心是一个javascript插件,只要稍作修改,便能按需求定制出不同格式的说明文档,在github上更是基于它集成到各种语言环境,分支众多。

其官方提供了一个离线版本,它的使用方法十分简单:直接在js格式的资源文件中录入REST API的json信息,便能容易地生成不同模块下的API列表,每个API接口描述和参数、请求方法都能在每个json数组中定制。下面是目前项目中使用到的部分预览图:





Swagger-UI 的官方地址:

http://swagger.wordnik.com

Github上的项目地址:

https://github.com/wordnik/swagger-ui

官方提供的demo地址

http://petstore.swagger.wordnik.com/

------------------------------------------

2012年10月19日更新:

下面是自己目前修改后的demo:

1. 添加了window.swaggerUi 中的几个参数(说明文件),更方便资源文件的编写

2. 修复了测试时post方法的bug

3. 界面显示中文

4. 根据每个接口的更新情况,定制了一些修订说明

附件(swagger-ui-editby-ekin.zip)
分享到:
评论
10 楼 u013768076 2016-12-01  
9 楼 静之恒v 2016-07-14  
请问swagger在发送POST请求有BUG,要如何修改,在其他地方看到你说:注释掉swagger-ui.js文件中的一行,请问是哪一行呢,谢谢。
8 楼 f756692193 2016-01-15  
看了说明,还是不知道怎么使用啊
7 楼 f756692193 2016-01-15  
whfandtank 写道
有本地的demo嘛,简单定义好的

同求
6 楼 zwsong 2015-11-25  
5 楼 whfandtank 2015-05-05  
有本地的demo嘛,简单定义好的
4 楼 ron.luo 2014-12-29  
请问下,swagger-ui-editby-ekin.zip这个不整合到系统中,单独使用吗?
3 楼 ron.luo 2014-08-24  
怎么部署测试呢?
2 楼 ron.luo 2014-08-04  
很牛逼啊,大赞。
1 楼 huaganshang 2013-06-24  
您好,是不是还需要指定自己的api-key

相关推荐

    项目API文档在线自动生成 Swagger UI.zip

    Swagger-UI更倾向于在线测试接口和数据,但其核心是一个javascript插件,只要稍作修改,便能按需求定制出不同格式的说明文档,在github上更是基于它集成到各种语言环境,分支众多。 其官方提供了一个离线版本,它...

    swagger-ui-master.zip_Swagger favicon.ico_restful_restful api_sw

    这个"swagger-ui-master.zip"文件包含的是Swagger UI的源代码,使得开发者能够自定义和集成到自己的项目中,以提供API文档和交互式测试功能。Swagger是Swagger UI的核心组件,它遵循OpenAPI规范,这个规范是一种标准...

    swagger-editor-master.zip

    2. **实时预览**:在编辑过程中,Swagger Editor会实时渲染API文档,展示API的结构和用法,帮助开发者检查和验证规范的正确性。 3. **YAML与JSON切换**:Swagger Editor支持在YAML和JSON两种格式之间自由切换。YAML...

    java8看不到源码-swagger-codegen-springboot:准备使用Swagger代码生成示例,使用swagger-codeg

    及其使用方法的最新文档并不容易找到。 该项目的目标是: 展示如何使用 OpenAPI 规范文件生成服务器代码(此处为接口和模型类)。 避免代码生成时覆盖代码的问题。 提供一个已设置并准备运行的项目,您可以将其用作...

    tornado-rest-swagger:龙卷风集成Swagger API 3.0

    tornado-rest-swagger:龙卷风服务器的Swagger API文档构建器。 受软件包的启发(基于此软件包的来源)。 文献资料 代码 问题 Python版本 python2.7和Python 3.5及更高版本 Swagger语言规范 安装 pip install -...

    rest api 接口测试工具

    4. Swagger UI:基于Swagger规范,提供交互式API文档和测试功能。 五、最佳实践 1. 文档驱动:确保有详细的API文档,方便测试人员理解和测试。 2. 自动化测试:通过编写测试脚本,实现持续集成和自动化回归测试。 3...

    swagger api开发使用说明书1

    4. **浏览 API** - 在 Swagger UI 中,你可以看到已扫描到的 Controller 类列表,点击相应的类名展开查看其包含的接口。 5. **查看接口详情** - 点击 "Expand Operations" 可以查看接口的详细信息,包括 HTTP 方法、...

    springboot vue element-ui

    1. 创建Spring Boot项目,配置相关依赖如Spring Web、Spring Data JPA(如果需要数据库操作)和Springfox(用于生成Swagger文档,方便API调试)。 2. 在前端,初始化一个Vue.js项目,安装Element-UI及相关插件,如...

    swagger-cxf:带有多个 CXF 端点的 Swagger 示例

    Swagger-CXF 是一个示例项目,它展示了如何在 Apache CXF 服务中集成 Swagger,以实现 RESTful API 的文档化和测试。Swagger 是一个流行的工具,用于构建、部署和管理 API,而 CXF 是一个开源服务框架,广泛用于构建...

    java8stream源码-rpa-em-annotation-app:rpa-em-annotation-app

    文档管理是用于存储和检索文档的后端服务。 科技 它用: Java8 弹簧靴 Junit、Mockito 和 SpringBootTest 和 Powermockito Gradle - Lombok项目 插件 - Lombok IDEA 插件 快速开始 # Cloning repo and running ...

    hexo-theme-doc:Hexo博客框架的文档主题

    它与其他Hexo主题不同,它允许您呈现文档,尤其是REST API文档。 由JavaScript / Node.js开发人员创建的hexo-theme-doc利用Hexo的和插件系统来添加自定义标签,自定义布局以及处理多种来源,这使得生成静态网站比...

    Python库 | drf-spectacular-sidecar-2021.10.18.tar.gz

    5. **错误处理和日志记录**:可能增加了对错误处理的改进,使得在API文档生成过程中遇到的问题能够被更好地捕获和记录,以便于调试和问题排查。 6. **新特性和API兼容性**:`drf-spectacular-sidecar-2021.10.18`...

    springboot+swagger的一个小Demo

    Swagger2则作为一个插件,通过扫描SpringBoot应用中的Controller和相关注解,生成详细的API文档。开发者通常会在SpringBoot的启动类上添加@EnableSwagger2注解开启Swagger2的功能,然后定义一个Docket Bean来配置...

    api-explorer:API Explorer是SwaggerOpenAPI规范的实时文档客户端

    可扩展:API Explorer提供基于插件的可扩展系统,使您可以控制UI的多个方面,与API端点的交互以及API规范。 API规范加载程序:它与Swagger(v1,v2)API规范预先捆绑在一起,但可以扩展以处理其他规范。 多个API ...

    lamp-cloud微服务脚手架

    基于Mybatis-plus-generator自定义了一套代码生成器, 通过配置数据库字段的注释,自动生成枚举类、数据字典注解、SaveDTO、UpdateDTO、表单验证规则注解、Swagger注解等。 16、定时任务调度器: 基于xxl-jobs进行了...

    java8源码-springboot:springboot2实践

    java8 源码 基于 spring-boot2 的模版模版项目 目标 ...<artifactId>springfox-swagger-ui</artifactId> ${swagger.version}</version> </dependency> 依赖这两个 再配置一下 @Bean public Docket d

    flask-restx:Flask-RESTPlus的Fork:功能齐全的框架,用于通过Flask快速,轻松地进行文档化的API开发

    2. **自动文档**:借助内置的Swagger UI集成,Flask-RESTX允许开发者以JSON格式定义API规范,并自动生成交互式文档。Swagger UI是一个流行的工具,可以直观地展示API的结构、参数和响应,方便测试和调试。 3. **...

    rest_api_demo:基于Flask-RESTPlus的RESTful API的样板代码

    Flask-RESTPlus是Flask的一个扩展,为构建RESTful API提供了便利,包括自动化的API文档、模型验证、错误处理等功能。 **Flask框架** Flask是一个轻量级的Python Web服务器网关接口(WSGI)应用框架。它具有简洁的...

    Python库 | drf_spectacular-0.13.0-py2.py3-none-any.whl

    `drf_spectacular` 是一个针对 Django REST Framework(DRF)的自动API文档生成工具,它允许开发者快速、方便地为自己的API创建详尽的OpenAPI规范。这个库在版本0.13.0中发布,提供了对Python 2和3的兼容性,文件名...

Global site tag (gtag.js) - Google Analytics