Chinese, Simplified
SEO Title
Current OpenAPI Version
3.0.2 - Link to the specification
Security
通过探索OpenAPI规范,一些工具可以查找您可能没有注意到的攻击向量。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
API Contract Security Audit - 上传OpenAPI文件,获取包含已定位漏洞的详细报告,可能的攻击方案,补救方法。 | SaaS | ✅ | ❌ |
Converters
各种工具可以转换为OpenAPI标准。 适用于各种API格式。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
Apimatic Transformer - 转换来自RAML,API Blueprint,OAI v2 / v3,WSDL等的API描述。 | SaaS | ✅ | ✅ | |
API Flow - 从多种格式转换为多种格式。 链接到菲尔的叉子因为原件完全坏了 | JavaScript | ✅ | ???? | |
Google Gnostic - 将OpenAPI描述编译为等效的 Protocol Buffer 表示 | Go | ✅ | ✅ | |
swagger2openapi - 将规格从OpenAPI v2.0升级到v3.0,捆绑到一个大型文件或尊重$ refs | Node.js | ✅ | ✅ | |
OAS RAML Converter -在OAS和RAML API规范之间进行转换 | Node.js | ✅ | ✅ | |
OData OpenAPI - OData 4.0 to OpenAPI 3.0.0 转换 | XSLT | ✅ | ✅ | |
OpenAPI Filter -从OpenAPI定义中过滤内部组件 | Node.js | ✅ | ✅ | |
OData.OpenAPI -将Edm(实体数据模型)转换为OpenApi 3.0 | .NET | ❌ | ✅ | |
pyswagger - Python中的客户端和转换器,类型安全,动态,规范兼容。 | Python | ✅ | ???? | |
odata2openapi - OData 4.0 to OpenAPI 2 转换 | Node.js | ✅ | ❌ | |
avantation - 从HAR生成OpenAPI 3.x规范。 | TypeScript | ❌ | ✅ | |
OpenAPI Generator -模板驱动的引擎,通过解析OpenAPI定义(社区驱动的swagger-codegen分支)生成不同语言的文档,API客户端和服务器存根 | Java | ✅ | ✅ | |
go-swagger -一切都在一个。 解析器,验证器,从代码生成规范,或从规范生成代码! | Go | ✅ | ???? |
Documentation
生成器可帮助构建基于各种格式和标准的API文档。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
APIMatic Developer Experience Portal - Customizable developer portals packed with language specific documentation, client libraries, code samples, an API console and much more. | SaaS | ✅ | ✅ | |
Kong Enterprise Edition - Highly customizable developer portal with developer onboarding, integrated with the Kong API Gateway | Lua | ✅ | ✅ | |
LucyBot DocGen - Generate a customizable website, with API documentation, console, and interactive workflows, from an OpenAPI spec | JavaScript | ✅ | ✅ | |
openapi-viewer - Browse and test a REST API described with the OpenAPI 3.0 Specification | Vue.js | ❌ | ✅ | |
openapi-ui - React based OpenAPI 3.0+ documentation generator | React.js | ❌ | ✅ | |
ReDoc - OpenAPI/Swagger-generated API Reference Documentation | React.js | ✅ | ✅ | |
widdershins - Generate Slate/Shins markdown from OpenAPI 2.0/3.0.x | Node.js | ✅ | ✅ | |
openapi3-generator - Use your API OpenAPI 3 definition to generate code, documentation, and literally anything you need. | Node.js | ❌ | ✅ | |
MrinDoc - Open API spec viewer. | Vue.JS | ✅ | ✅ | |
RapiDoc - Custom Element to view OpenAPI spec. | Custom Element | ✅ | ✅ | |
RapiPdf - Custom Element to generate PDF from OpenAPI spec. | Custom Element | ✅ | ✅ | |
Stoplight - Create beautiful, customizable, interactive API documentation generated from your OpenAPI Specification, integrated with the Stoplight platform | SaaS | ✅ | ✅ | |
Bump - Bump generates elegant documentations and changelogs from your OpenAPI specifications. Git diff, for your API. | SaaS | ✅ | ✅ |
Text Editors
文本编辑器,以帮助构建API文档。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
VSCode/OpenAPI (Swagger) editor - OpenAPI (Swagger) 2.0/3.0.x plugin for Visual Studio Code - new file templates, navigation, intellisense, code snippets | Any | ✅ | ✅ | |
KaiZen-OpenAPI-Editor - Full-featured Eclipse editor for OpenAPI 2.0 and 3.0, also available on Eclipse Marketplace. | Java | ✅ | ✅ | |
Atom/linter-swagger - This plugin for Atom Linter will lint Swagger 2.0 specifications or OpenAPI 3.0, both JSON and YAML using swagger-parser node package. | JavaScript | ✅ | ✅ | |
Swagger Editor - Design, describe, and document your API on the first open source editor fully dedicated to OpenAPI-based APIs. | Node.js | ✅ | ✅ | |
SwaggerHub - API design and documentation platform to improve collaboration, standardize development workflow and centralize their API discovery and consumption. | SaaS/On-Premise NodeJS | ✅ | ✅ | |
Senya Editor - Design API specifications fast and effectively in your favorite JetBrains IDE. | Java | ✅ | ✅ | |
VSCode/openapi-lint - OpenAPI (Swagger) 2.0/3.0.x intellisense, validator and linter for Visual Studio Code | Node.js | ✅ | ✅ |
GUI Editors
Visual editors to help build API docs.
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
RepreZen API Studio - RepreZen API Studio is an integrated workbench that brings API-first design into focus for your whole team, harmonizes your API designs, and generates APIs that click into client apps. | Java | ✅ | ✅ | |
Apicurio Studio - A standalone API design studio that can be used to create new or edit existing API designs. | TypeScript | ✅ | ✅ | |
Stoplight - Stoplight is the Complete OpenAPI Specification Toolkit that leverages your OpenAPI documents to drive the entire API development process | SaaS | ✅ | ???? | |
OpenAPI-GUI - OpenAPI-GUI is a GUI for creating and editing OpenAPI version 3.0.x JSON/YAML definitions. | JavaScript | ❌ | ???? |
Mock Servers
加速API测试和开发的服务和平台。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
Connexion - OpenAPI First framework for Python on top of Flask with automatic endpoint validation & OAuth2 support | Python | ✅ | ✅ | |
Prism - Turn any OAI file into an API server with mocking, transformations, validations, and more. | cli | ✅ | ✅ | |
Sandbox - SaaS, self-hosted, or CLI tool for turning OpenAPI (and other) definitions into a mock server, where you can modify behaviour, simulate downtime, and any other nonsnese you can think of thanks to a built-in code editor! | SaaS / Java | ✅ | ???? | |
Microcks - Mocking and testing platform for API and microservices. Turn your OAI contract examples into ready to use mocks. Use examples to test and validate implementations according schema elements. | Self-hosted / SaaS | ✅ | ✅ | |
API Sprout - Lightweight, blazing fast, cross-platform OpenAPI 3 mock server with validation | cli / Docker | ❌ | ✅ | |
MockLab - SaaS platform to upload your spec to create a mock server | SaaS | ✅ | ✅ | |
Fakeit - Create mock server from OpenAPI 3 specification with random response generation and request validation. | cli / Docker | ❌ | ✅ |
Server implementations
轻松创建和实现API的资源和路由。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
Vert.x Web Api Contract - Create API endpoints with Vert.x 3 and OpenAPI 3 with automatic requests validation | Java, Kotlin, JavaScript, Groovy, Ruby, Ceylon & Scala | ❌ | ✅ | |
BaucisJS + baucis-openapi3 - Create REST resources with persistence on MongoDB and expose OpenAPI v.3 contracts | JavaScript | ❌ | ✅ | |
BaucisJS + baucis-swagger2 - Create REST resources with persistence on MongoDB and expose OpenAPI v.2 contracts | JavaScript | ✅ | ❌ | |
@smartrecruiters/openapi-first - Initializes your API express application with specification in OpenAPI Specification 3.0 format using provided middlewares (parsers, validators, controller, defaults setting) or custom ones | Node.js | ❌ | ✅ | |
openapi-backend - Build, Validate, Route, and Mock using OpenAPI specification. Framework-agnostic | Node.js | ❌ | ✅ | |
OpenAPI Enforcer Middleware - An express middleware that makes it easy to write web services that follow an Open API specification by leveraging the tools provided in the openapi-enforcer package. | Node.js | ✅ | ✅ | |
MicroTS - Code generator - from OpenAPI specification generates TypeScript project with Docker. | Node.js | ✅ | ✅ | |
API Platform - REST and GraphQL framework to build modern API-driven projects | PHP | ✅ | ✅ | |
Mojolicious::Plugin::OpenApi - Mojolicious::Plugin::OpenAPI is a plugin for Mojolicious framework that add routes and input/output validation to your Mojolicious application based on a OpenAPI (Swagger) specification. Currently v2 is very well supported, while v3 should be considered EXPERIMENTAL. | Perl | ✅ | ✅ | |
Fusio - Open source API management platform | PHP | ❌ | ✅ |
Miscellaneous
用于加载文档和解析引用的工具。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
OpenAPI Server Code Generator (oapi-codegen) - Generate a web service using the [Echo](https://github.com/labstack/echo) framework from an Open API v3 specification | Go | ❌ | ✅ | |
Sway - A library that simplifies OpenAPI integrations/tooling. | JavaScript | ✅ | ???? | |
openapi-diff - Utility for comparing two OpenAPI specifications. | Java | ❌ | ✅ | |
$ oas (CLI) - Generate OAS files from code comments and easily host them ($ npm install oas -g) | JavaScript | ✅ | ✅ |
Parsers
在验证规范和文档时,在版本之间序列化和迁移API文档。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
swagger-parser - OpenAPI Specification parser which is still using the name "Swagger' because they're stubborn. New versions are v3 only, older versions support v1.x/v2. | Java | ✅ | ✅ | |
BigstickCarpet/swagger-parser - Swagger/OpenAPI 2.0 and 3.0 parser and validator. Can also bundle multiple files into one via `$ref`. | Node.js | ✅ | ✅ | |
KaiZen OpenAPI Parser - High-performance Parser, Validator, and Java Object Model for OpenAPI 3.x | Java | ❌ | ✅ | |
OpenAPI-TS - TS Model & utils for OpenAPI 3.0.x contracts | TypeScript | ❌ | ✅ | |
kin-openapi - A Go library for handling OpenAPI 3.0 specifications | Go | ❌ | ✅ | |
php-openapi - A PHP library for handling OpenAPI 3.0 specifications | PHP | ❌ | ✅ | |
Object Oriented OpenAPI Specification - An object oriented approach to generating OpenAPI specs, implemented in PHP | PHP | ❌ | ✅ | |
OpenAPI3-Rust - Rust serialization library for OpenAPI v3 | Rust | ❌ | ✅ | |
psx-api - Parse and generate API specification formats | PHP | ✅ | ✅ | |
Microsoft/OpenAPI.NET - C# based parser with definition validation and migration support from V2 | .NET | ✅ | ✅ | |
oas_parser - A Ruby parser for Open API Spec 3.0+ definitions. | Ruby | ❌ | ✅ | |
openapi3 - An OpenAPI 3 Specification client, and validator, covering both schema validation and limited data validation for Python 3. | Python | ❌ | ✅ | |
Spot - A concise, developer-friendly way to describe your API contract. | TypeScript | ✅ | ✅ |
Schema Validators
使用这些工具快速轻松地验证API架构。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
Speccy - Lint to enforce quality rules on your OpenAPI specifications | CLI | ❌ | ✅ | |
BigstickCarpet/swagger-cli - A handy cli tool for validating JSON or YAML files schema files that respects $ref | Node.js / CLI | ✅ | ✅ | |
openapi-spec-validator - OpenAPI Spec validator | Python | ✅ | ✅ | |
Sway - A library that simplifies OpenAPI integrations/tooling. | JavaScript | ✅ | ???? | |
oval - CLI for (O)penAPI Specification document (val)idation. | JavaScript | ✅ | ???? | |
Spectral - A flexible JSON object linter with out of the box support for OpenAPI Specification | TypeScript/JavaScript | ✅ | ✅ | |
OpenAPI Enforcer - Tool to 1) Validate your OAS document, 2) serialize, deserialize, and validate incoming requests and outgoing responses, 3) simplify response building, and 4) producing mock data. Exensible via plugins. | Node.js | ✅ | ✅ | |
php-openapi - A PHP library for handling OpenAPI 3.0 specifications | PHP | ❌ | ✅ |
Data Validators
帮助您验证API数据的工具。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
Sway - A library that simplifies OpenAPI integrations/tooling. | JavaScript | ✅ | ???? | |
Openapi validator - Library that checks response against Openapi schema, based on request path and method | PHP | ❌ | ✅ | |
express-ajv-swagger-validation - Express middleware which validates request body, headers, path parameters and query parameters according to the OpenAPI Specification | Node.js | ✅ | ✅ | |
committee - Validation middleware for Rack server. This gem validates request and response using OpenAPI Specification. And convert parameter string to specific Ruby object (e.g. convert datetime string to DateTime class). | Ruby | ✅ | ✅ | |
OpenAPI Enforcer - Tool to 1) Validate your OAS document, 2) serialize, deserialize, and validate incoming requests and outgoing responses, 3) simplify response building, and 4) producing mock data. Exensible via plugins. | Node.js | ✅ | ✅ | |
OpenAPI Validation Middleware - a PSR-7 and PSR-15 middleware to validate requests and responses against your OpenAPI spec | PHP | ❌ | ✅ | |
kin-openapi - A Go library for handling OpenAPI 3.0 specifications | Go | ❌ | ✅ | |
openapi-psr7-validator - It validates PSR-7 messages against OpenAPI specifications | PHP | ❌ | ✅ |
Testing
快速执行API请求并通过命令行或GUI界面动态验证响应。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
Dredd - Language-agnostic command-line tool for validating API description document against backend implementation of the API | Javascript | ✅ | ✅ | |
Openapi validator - Library that checks response against Openapi schema, based on request path and method | PHP | ❌ | ✅ | |
OpenAPI Enforcer - Tool to 1) Validate your OAS document, 2) serialize, deserialize, and validate incoming requests and outgoing responses, 3) simplify response building, and 4) producing mock data. Exensible via plugins. | Node.js | ✅ | ✅ | |
Chai OpenAPI Response Validator - Simple Chai support for asserting that HTTP responses satisfy an OpenAPI spec. | Node.js | ✅ | ✅ | |
hikaku - A library that tests if the implementation of a REST-API meets its specification. | Kotlin | ❌ | ✅ | |
Swagger Inspector - Swagger Inspector is a free online tool to quickly execute any API request, validate its responses and generate a corresponding OpenAPI definition. | Self-hosted/SaaS | ✅ | ✅ | |
Assertible - Import an OpenAPI specification into Assertible to generate tests that validate JSONSchema responses and status codes on every endpoint. | SaaS | ✅ | ✅ |
SDK Generators
通过创建SDK快速生成文档,描述和客户端。
Name | Language | v2 | v3 | GitHub |
---|---|---|---|---|
OpenAPI Generator - A template-driven engine to generate documentation, API clients and server stubs in different languages by parsing your OpenAPI definition (community-driven fork of swagger-codegen) | Java | ✅ | ✅ | |
APIMatic CodeGen - Bring in your API description (OAI v2/v3, RAML, API Blueprint, WSDL, etc.) to generate fully functional SDKs in over 10 languages. | SaaS | ✅ | ✅ | |
janephp/open-api - Generate a PHP Client API (PSR7 compatible) given a OpenAPI specification. | PHP | ✅ | ✅ | |
go-swagger - Everything all in one. Parser, validator, generates spec from code, or code from spec! | Go | ✅ | ???? | |
guardrail - Principled code generation from OpenAPI Specifications | Scala, Java, ... | ✅ | ✅ |
发布日期
星期四, June 13, 2019 - 21:56
最后修改
星期四, 一月 5, 2023 - 21:57
Article
最新内容
- 1 week 5 days ago
- 2 weeks 6 days ago
- 3 weeks 2 days ago
- 3 weeks 2 days ago
- 3 weeks 5 days ago
- 3 weeks 6 days ago
- 4 weeks ago
- 4 weeks 1 day ago
- 4 weeks 1 day ago
- 4 weeks 1 day ago