swagger-api/swagger-ui

最新推荐文章于 2025-10-07 05:54:31 发布

原创最新推荐文章于 2025-10-07 05:54:31 发布 · 564 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#mysql

php 专栏收录该内容

30 篇文章

订阅专栏

Swagger UI 提供了三个不同的 NPM 模块，适用于不同场景：swagger-ui 适用于单页应用，swagger-ui-dist 适用于服务器端项目或无法解决 npm 依赖的单页应用，而 swagger-ui-react 则是作为 React 应用的组件。建议单页应用使用 swagger-ui，因为其体积更小。此外，Swagger UI 兼容 OpenAPI 规范的多个版本，包括 2.0 和 3.0。

部署运行你感兴趣的模型镜像

This repository publishes three different NPM modules:

swagger-ui is a traditional npm module intended for use in single-page applications that are capable of resolving dependencies (via Webpack, Browserify, etc).
swagger-ui-dist is a dependency-free module that includes everything you need to serve Swagger UI in a server-side project, or a single-page application that can’t resolve npm module dependencies.
swagger-ui-react is Swagger UI packaged as a React component for use in React applications.
We strongly suggest that you use swagger-ui instead of swagger-ui-dist if you’re building a single-page application, since swagger-ui-dist is significantly larger.

Compatibility
The OpenAPI Specification has undergone 5 revisions since initial creation in 2010. Compatibility between Swagger UI and the OpenAPI Specification is as follows:

Swagger UI Version Release Date OpenAPI Spec compatibility Notes
3.18.3 2018-08-03 2.0, 3.0 tag v3.18.3
3.0.21 2017-07-26 2.0 tag v3.0.21
2.2.10 2017-01-04 1.1, 1.2, 2.0 tag v2.2.10
2.1.5 2016-07-20 1.1, 1.2, 2.0 tag v2.1.5
2.0.24 2014-09-12 1.1, 1.2 tag v2.0.24
1.0.13 2013-03-08 1.1, 1.2 tag v1.0.13
1.0.1 2011-10-11 1.0, 1.1 tag v1.0.1
Documentation
Usage
Installation
Configuration
CORS
OAuth2
Deep Linking
Limitations
Version detection
Customization
Overview
Plugin API
Custom layout
Development
Setting up
Scripts
Integration Tests
You will need JDK of version 7 or higher as instructed here https://nightwatchjs.org/gettingstarted/#selenium-server-setup

Integration tests can be run locally with npm run e2e - be sure you aren’t running a dev server when testing!

Browser support
Swagger UI works in the latest versions of Chrome, Safari, Firefox, and Edge.

Known Issues
To help with the migration, here are the currently known issues with 3.X. This list will update regularly, and will not include features that were not implemented in previous versions.

Only part of the parameters previously supported are available.
The JSON Form Editor is not implemented.
Support for collectionFormat is partial.
l10n (translations) is not implemented.
Relative path support for external files is not implemented.
Security contact
Please disclose any security-related issues or vulnerabilities by emailing security@swagger.io, instead of using the public issue tracker.

您可能感兴趣的与本文相关的镜像

Dify

AI应用

Agent编排

Dify 是一款开源的大语言模型（LLM）应用开发平台，它结合了后端即服务(Backend as a Service) 和LLMOps 的理念，让开发者能快速、高效地构建和部署生产级的生成式AI应用。它提供了包含模型兼容支持、Prompt 编排界面、RAG 引擎、Agent 框架、工作流编排等核心技术栈，并且提供了易用的界面和API，让技术和非技术人员都能参与到AI应用的开发过程中