Swagger UI

Swagger UI 是 HTML、Javascript 和 CSS 资产的集合,可以从符合 Swagger 的 API 动态生成漂亮的文档。(Swagger UI is a collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.)

Github stars Tracking Chart

NPM version
Build Status
npm audit
total GitHub contributors

monthly npm installs
total docker pulls
monthly packagist installs
gzip size

?? Want to score an easy open-source contribution? Check out our Good first issue label.

?️ Looking for the older version of Swagger UI? Refer to the 2.x branch.

This repository publishes to 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

Main metrics

Overview
Name With Ownerswagger-api/swagger-ui
Primary LanguageJavaScript
Program languageCSS (Language Count: 6)
PlatformDocker, Linux, Mac, Windows
License:Apache License 2.0
所有者活动
Created At2011-07-15 22:56:39
Pushed At2025-04-18 23:50:08
Last Commit At2025-04-13 19:37:38
Release Count416
Last Release Namev5.21.0 (Posted on 2025-04-13 19:37:46)
First Release Namev1.0 (Posted on 2011-10-19 16:03:29)
用户参与
Stargazers Count27.2k
Watchers Count643
Fork Count9.1k
Commits Count6.7k
Has Issues Enabled
Issues Count5592
Issue Open Count1184
Pull Requests Count3249
Pull Requests Open Count98
Pull Requests Close Count1083
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private