Swagger/OpenAPI 查看器

在线渲染 OpenAPI 2.0/3.0 规范文档，支持 JSON 和 YAML 格式，完整解析 $ref 引用，支持解析后在线预览、在线调试、在线生成pdf、下载pdf。

点击「生成文档」查看 API 结构
相关工具： Postman转Swagger Swagger转Markdown
关于 OpenAPI / Swagger
  • OpenAPI 规范（OAS）是描述 RESTful API 的行业标准，前身即 Swagger 2.0
  • 当前主流版本为 OpenAPI 3.0 / 3.1，支持 JSON 和 YAML 两种格式
  • 本工具使用 Swagger UI 官方组件渲染，完整支持 $ref 引用展开、数据模型展示、认证信息等
  • 常见工具链：Swagger UI（可视化）、OpenAPI Generator（代码生成）、Redoc（文档渲染）
操作说明
  • 粘贴 OpenAPI JSON 或 YAML 规范到左侧输入框，点击「渲染文档」
  • 点击「导入」可选择本地 .json / .yaml / .yml 文件，或直接拖拽文件到输入区域
  • 选择「JSON 示例」或「YAML 示例」可快速填入演示规范体验渲染效果
  • 快捷键：Ctrl + Enter 执行渲染
  • 渲染后可在右侧展开各接口查看参数、响应及 Schema 详情；点击「新窗口打开」可全屏浏览
  • 点击「导出 PDF」可将当前规范生成结构化 PDF 文档，包含接口列表、请求参数、响应及数据模型
注意事项
  • 「Try it out」功能需要目标 API 服务器支持 CORS，本地规范无法直接发起请求
  • 超大规范文件（>1MB）渲染可能稍慢，建议拆分后分批查看
  • 所有数据在浏览器本地处理，不会上传到服务器；导出 PDF 功能需将规范内容发送至服务端生成，不会持久化存储
OpenAPI / Swagger 知识详解
Swagger 2.0 vs OpenAPI 3.0 vs 3.1 对比
对比项 Swagger 2.0 OpenAPI 3.0 OpenAPI 3.1
发布时间 2014 2017 2021
根字段 swagger: "2.0" openapi: "3.0.x" openapi: "3.1.x"
服务器定义 host + basePath servers 数组（支持多服务器）
请求体 in: body 参数 requestBody 独立字段
JSON Schema 兼容 部分兼容（子集） 部分兼容（扩展子集） 完全兼容 JSON Schema Draft 2020-12
Webhook 支持 ❌ ❌ ✅ 原生支持
工具生态 成熟，大量遗留工具 主流，广泛支持 逐步普及中
OpenAPI 3.0 文档核心结构 
openapi: 3.0.0
info:          # 文档元信息
  title: ...
  version: ...
servers:       # 服务器地址列表
  - url: ...
paths:         # 接口路径定义
  /users:
    get: ...
    post: ...
components:    # 可复用组件
  schemas: ... # 数据模型
  securitySchemes: ...
security:      # 全局安全要求
tags:          # 接口分组标签
字段说明必填
openapi规范版本号✅
infoAPI 标题、版本、描述✅
paths所有接口路径及操作✅
servers服务器 URL 列表❌
components可复用的 Schema、参数等❌
security全局认证方案❌
tags接口分组标签定义❌
$ref 引用机制详解

$ref 是 JSON Reference 标准，用于在文档内部或跨文件复用定义，避免重复描述相同的数据结构。

文档内部引用（最常用）
# 定义（components/schemas）
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: string

# 引用
responses:
  '200':
    content:
      application/json:
        schema:
          $ref: '#/components/schemas/User'
可引用的组件类型
路径前缀用途
#/components/schemas/数据模型
#/components/parameters/请求参数
#/components/responses/响应定义
#/components/requestBodies/请求体
#/components/headers/响应头
#/components/securitySchemes/认证方案
常见认证方案配置
认证类型配置示例适用场景
Bearer JWT type: http, scheme: bearer, bearerFormat: JWT 现代 REST API，前后端分离
API Key type: apiKey, in: header, name: X-API-Key 开放平台、第三方集成
OAuth 2.0 type: oauth2, flows: { authorizationCode: ... } 需要用户授权的场景
Basic Auth type: http, scheme: basic 内部系统、简单场景（不推荐生产）
OpenID Connect type: openIdConnect, openIdConnectUrl: ... 企业 SSO、身份联合
OpenAPI 生态工具链
工具用途说明
Swagger UI 可视化渲染 官方交互式文档，支持在线调试（本工具使用）
Redoc 文档渲染 三栏布局，适合对外发布的 API 文档
OpenAPI Generator 代码生成 从规范生成 50+ 语言的客户端/服务端代码
Stoplight Studio 可视化编辑 GUI 方式设计 API，无需手写 YAML/JSON
Spectral 规范校验 自定义规则校验 OpenAPI 文档质量
Prism Mock 服务器 根据规范自动生成 Mock API，前端可提前联调

相关工具

API在线调试工具

在线API调试工具，支持发送GET、POST、PUT、DELETE、PATCH等HTTP请求，可自定义请求头和请求体（JSON/Form/Raw），格式化展示响应结果、状态码和响应时间。支持导出为cURL命令，适合接口联调、API测试和快速验证HTTP接口行为。

浏览器信息查询

浏览器信息查询工具，实时检测并展示当前浏览器的详细信息。包括浏览器名称和版本、操作系统类型和版本、User-Agent字符串、屏幕分辨率和色深、设备像素比、Cookie和JavaScript支持状态、语言设置、时区信息等。对于前端开发者来说，了解用户浏览器环境是解决兼容性问题的第一步。可用于测试响应式设计、调试浏览器特性检测代码、收集用户环境信息，帮助开发者快速定位跨浏览器兼容性问题。

CIDR IP范围展开

在线CIDR IP范围展开工具，输入CIDR表示法（如192.168.1.0/24）自动计算网络地址、广播地址、子网掩码、可用IP数量和IP范围，支持展开列出所有IP地址（小网段），支持IPv4和IPv6。

Git提交信息生成

在线Git提交信息（commit message）生成工具，帮助开发者按照Conventional Commits规范快速生成规范的提交信息。通过选择提交类型（feat/fix/docs/style/refactor/perf/test/chore等）、填写影响范围（scope）和简短描述，自动生成符合规范的提交信息格式。支持添加详细正文说明和脚注（Breaking Change、关联Issue等），生成的提交信息可直接复制使用。规范的提交信息有助于自动生成CHANGELOG、语义化版本管理和团队协作。内置常用提交类型说明和示例，帮助团队统一提交风格，所有处理在浏览器本地完成。

Content-Type对照表

HTTP Content-Type（MIME媒体类型）完整对照表，收录常用文件类型对应的Content-Type值。涵盖文本类型（text/html、text/css、text/plain）、应用类型（application/json、application/xml、application/pdf）、图片类型（image/jpeg、image/png、image/gif）、音视频类型、多部分类型（multipart/form-data）等。帮助开发者在设置HTTP请求头、配置Web服务器、开发文件上传功能时快速查找正确的Content-Type值，是API开发和Web开发的必备参考工具。

Crontab表达式工具

在线Crontab表达式工具，提供Cron定时任务表达式的生成、解析和验证功能。通过可视化界面选择执行频率（分钟、小时、日期、月份、星期），自动生成对应的Cron表达式；也可输入已有Cron表达式，解析为人类可读的执行计划描述（如「每天上午9点执行」）。支持标准5段式Cron（Linux crontab）和6段式Cron（Spring/Quartz），显示最近10次执行时间预览，帮助验证表达式是否符合预期。内置常用Cron表达式模板（每分钟、每小时、每天、每周、每月等），适用于Linux定时任务配置、Spring定时任务开发、CI/CD定时触发配置等场景，所有处理在浏览器本地完成。

cURL命令生成器

在线cURL命令生成器，通过可视化界面配置HTTP请求参数，自动生成对应的cURL命令。支持所有常用HTTP方法、自定义请求头、多种请求体格式（JSON/Form/Raw）、Basic/Bearer认证，同时支持将cURL命令反向解析为可视化配置，所有处理在浏览器本地完成。

DNS查询

在线DNS查询工具，支持查询域名的各类DNS记录，包括A记录（IPv4地址）、AAAA记录（IPv6地址）、MX记录（邮件服务器）、CNAME记录（别名）、TXT记录（文本信息/SPF/DKIM）、NS记录（域名服务器）、SOA记录等。可用于验证DNS配置是否生效、排查域名解析故障、检查邮件服务器配置、验证SSL证书域名等场景。是网站运维、域名管理、网络故障排查的必备工具，帮助开发者和运维人员快速诊断DNS相关问题。

Docker Compose生成器

在线Docker Compose配置文件生成器，通过可视化界面快速生成docker-compose.yml配置文件。支持添加多个服务（Web应用、数据库、缓存、消息队列等），配置镜像、端口映射、环境变量、数据卷挂载、网络设置、依赖关系（depends_on）、健康检查等参数。内置常用服务模板（MySQL、PostgreSQL、Redis、MongoDB、Nginx、RabbitMQ、Elasticsearch等），一键添加并自动填充推荐配置。生成的配置文件符合Docker Compose v3规范，可直接用于本地开发环境搭建和测试环境部署。适用于微服务本地联调、开发环境标准化、快速搭建技术栈演示环境等场景，所有处理在浏览器本地完成。

Dockerfile生成器

在线Dockerfile生成器，根据项目技术栈快速生成符合最佳实践的Dockerfile模板。支持多种运行时环境（Node.js、Python、Java/Spring Boot、.NET、Go、PHP、Ruby等），自动生成包含基础镜像选择、工作目录设置、依赖安装、代码复制、端口暴露、启动命令等完整配置的Dockerfile。生成的Dockerfile遵循Docker最佳实践：使用多阶段构建（Multi-stage Build）减小镜像体积、合并RUN指令减少层数、使用.dockerignore排除无关文件、以非root用户运行等。适用于新项目容器化、学习Docker最佳实践、快速搭建开发环境等场景，所有处理在浏览器本地完成。

文件编码格式检测

在线文件编码格式检测工具，上传文本文件自动检测编码格式（UTF-8/GBK/GB2312/Shift-JIS等），显示检测置信度和BOM信息，支持将文件转换为UTF-8编码后下载。所有处理在浏览器本地完成。

Git命令速查表

Git命令速查表，收录Git版本控制系统的常用命令及详细说明。按功能分类整理，涵盖仓库初始化、文件暂存、提交管理、分支操作、远程仓库、标签管理、日志查看、撤销回退、变基合并等各类场景的Git命令。每条命令附有参数说明和使用示例，帮助开发者快速查找所需命令。支持关键词搜索快速定位命令，适合Git初学者学习和有经验开发者日常查阅。内容涵盖git init、git clone、git add、git commit、git push、git pull、git branch、git merge、git rebase、git stash等核心命令的完整用法，是日常开发的实用参考手册。

Git Diff在线查看

在线Git Diff查看工具，将git diff输出的补丁格式（unified diff）以高亮可视化方式展示代码变更。支持粘贴git diff、git show或patch文件内容，以红绿高亮对比形式展示新增行、删除行和上下文，清晰呈现代码变更内容。支持并排对比（Side-by-Side）和上下对比（Inline）两种视图模式，可折叠未变更的上下文行。适用于代码审查时快速理解变更内容、分析开源项目的补丁文件、展示代码修改记录等场景。无需安装Git客户端即可查看diff内容，所有处理在浏览器本地完成，代码不上传服务器。

.gitignore文件生成

在线.gitignore文件生成工具，根据项目技术栈快速生成合适的.gitignore配置文件。支持选择多种编程语言（Java、Python、Node.js、C#、Go、Ruby等）、开发框架（Spring Boot、Django、React、Vue、Angular等）、IDE工具（VS Code、IntelliJ IDEA、Eclipse、Xcode等）和操作系统（Windows、macOS、Linux），自动合并生成包含所有相关忽略规则的.gitignore文件。生成的规则覆盖编译产物、依赖目录、IDE配置文件、系统临时文件等常见需要忽略的内容，避免将无关文件提交到版本库，保持仓库整洁，所有处理在浏览器本地完成。

GraphQL Schema查看器

在线GraphQL Schema查看器，支持解析和浏览GraphQL Schema定义语言（SDL）格式的Schema文件。展示所有类型定义（Type、Input、Enum、Interface、Union）、查询（Query）、变更（Mutation）和订阅（Subscription）的完整结构，支持字段详情展开查看。GraphQL是Facebook开源的API查询语言，以其灵活的数据获取方式在现代API开发中广泛应用。本工具帮助开发者快速理解GraphQL API的数据结构，是GraphQL开发和对接的实用辅助工具，所有处理在浏览器本地完成。

Helm Chart模板生成

在线Helm Chart模板生成工具，快速生成标准的Helm Chart项目结构和模板文件。Helm是Kubernetes的包管理工具，通过Chart将应用的K8s资源打包为可复用的部署单元，支持参数化配置和版本管理。本工具根据应用信息（名称、版本、镜像、端口等）自动生成完整的Chart目录结构，包括Chart.yaml（Chart元数据）、values.yaml（默认配置值）、templates/deployment.yaml、templates/service.yaml、templates/ingress.yaml等标准模板文件。生成的模板遵循Helm最佳实践，使用命名模板和辅助函数，支持多环境配置覆盖。适用于应用K8s部署标准化、多环境配置管理、CI/CD流水线集成等场景，所有处理在浏览器本地完成。

HTTP请求头大全

HTTP请求头和响应头完整参考手册，收录HTTP/1.1和HTTP/2协议中所有标准头字段的详细说明。涵盖通用头（Cache-Control、Connection）、请求头（Accept、Authorization、Cookie、User-Agent、Referer）、响应头（Content-Type、Set-Cookie、Location、ETag）、实体头（Content-Length、Content-Encoding）等分类。每个头字段提供语法说明、取值示例和使用场景，是Web开发、API设计、网络调试的必备参考工具，帮助开发者正确配置HTTP头信息。

HTTP状态查询

HTTP状态码完整查询工具，收录所有HTTP状态码的含义、说明和使用场景。按类别分组展示：1xx（信息性状态码）、2xx（成功状态码，如200 OK、201 Created）、3xx（重定向状态码，如301、302、304）、4xx（客户端错误，如400、401、403、404）、5xx（服务器错误，如500、502、503）。每个状态码提供详细说明、常见原因和解决建议，是Web开发、API调试、服务器运维的必备参考工具，帮助开发者快速理解和处理HTTP错误。

HTTP请求格式转换

在线HTTP请求格式转换工具，将cURL命令转换为多种编程语言的HTTP请求代码，支持输出JavaScript Fetch、Axios、Python requests、Java HttpClient、C# HttpClient等格式。帮助开发者快速将接口调试命令转换为可直接使用的代码片段，所有处理在浏览器本地完成。

IP归属地查询

在线IP归属地查询工具，支持查询指定IP或当前访问者IP的国家、省份、城市、ISP、经纬度等信息，支持IPv4和IPv6，支持批量查询多个IP地址。

Kubernetes YAML生成器

在线Kubernetes（K8s）YAML配置文件生成器，通过可视化表单快速生成常用的K8s资源配置文件。支持生成Deployment（部署）、Service（服务）、ConfigMap（配置映射）、Secret（密钥）、Ingress（入口）、PersistentVolumeClaim（持久卷声明）、HorizontalPodAutoscaler（水平自动扩缩容）等核心资源的YAML配置。可配置副本数、容器镜像、资源限制（CPU/内存requests和limits）、环境变量、健康检查探针、标签选择器等关键参数，生成符合K8s规范的YAML文件。适用于K8s初学者学习资源配置、快速搭建应用部署配置、标准化团队K8s配置模板等场景，所有处理在浏览器本地完成。

Linux命令速查表

Linux命令速查表，收录Linux系统常用命令及详细说明，是开发者和运维人员的实用参考手册。按功能分类整理，涵盖文件操作（ls、cp、mv、rm、find）、文本处理（grep、sed、awk、sort、uniq）、进程管理（ps、top、kill、systemctl）、网络工具（curl、wget、netstat、ss、ping）、权限管理（chmod、chown、sudo）、磁盘管理（df、du、mount）、压缩解压（tar、gzip、zip）等各类场景命令。每条命令附有常用参数说明和实际使用示例，支持关键词搜索快速定位。适合Linux初学者系统学习和有经验的开发运维人员日常查阅，内容持续更新维护。

Meta标签分析工具

在线网页Meta标签分析工具，输入网页URL后自动抓取并解析页面的所有Meta标签信息。展示页面标题（title）、描述（description）、关键词（keywords）、Open Graph标签（og:title、og:image、og:description）、Twitter Card标签、Canonical链接、Robots指令等SEO相关信息。帮助SEO工程师和网站管理员快速检查网页的SEO配置是否完整规范，验证社交媒体分享预览效果，是网站SEO优化和内容营销的实用诊断工具。

Nginx配置生成器

在线Nginx配置文件生成器，支持静态网站、反向代理、HTTPS/HTTP2、负载均衡等场景，自动生成SSL最佳实践配置（HSTS/OCSP Stapling/安全头），支持Let's Encrypt证书路径，实时预览并下载配置文件。

OAuth2调试工具

在线OAuth2调试工具，支持授权码模式（Authorization Code）和客户端凭证模式（Client Credentials）的Token获取流程调试。可配置授权端点、Token端点、Client ID/Secret等参数，帮助开发者快速验证OAuth2集成配置，所有敏感信息仅在浏览器本地处理。

Postman Collection转Swagger

在线Postman Collection转Swagger/OpenAPI规范工具，将Postman导出的Collection JSON文件（v2.0/v2.1格式）转换为标准OpenAPI 3.0格式。自动提取Collection中的请求路径、HTTP方法、请求头、请求体、查询参数等信息，生成符合OpenAPI规范的JSON文档。适用于将Postman测试集合转换为正式API文档、与使用Swagger的团队共享API规范、将API文档导入其他支持OpenAPI的工具等场景，所有转换在浏览器本地完成，数据不上传服务器。

HTTP请求方法表

HTTP请求方法完整参考表，详细说明GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS、CONNECT、TRACE等所有HTTP方法的语义、特性和使用场景。每个方法标注是否幂等、是否安全、是否可缓存等特性，并提供RESTful API设计中的最佳实践建议。是Web开发、API设计、前后端联调的必备参考工具，帮助开发者正确选择和使用HTTP方法，设计符合REST规范的API接口，提升API的可读性和可维护性。

robots.txt生成器

在线robots.txt生成器，可视化配置爬虫规则，支持多User-agent规则组、Allow/Disallow路径规则、Sitemap声明，内置Googlebot/Bingbot/百度蜘蛛等常见爬虫预设，实时预览生成结果，支持复制和下载。

Shell脚本生成器

在线Shell脚本生成器，通过可视化配置快速生成常用的Bash/Shell脚本模板。支持生成多种类型的脚本模板：文件批量处理脚本、定时任务脚本、服务启停脚本、日志轮转脚本、备份脚本、部署脚本等。生成的脚本包含规范的头部注释（脚本说明、作者、日期、用法）、错误处理（set -e、set -u）、日志输出函数、参数解析等最佳实践代码框架。支持选择目标Shell类型（bash/sh/zsh）和执行环境（Linux/macOS）。适用于运维自动化、CI/CD流程脚本编写、系统管理任务自动化等场景，所有处理在浏览器本地完成。

子网掩码计算

在线子网掩码计算工具，输入IP地址和子网掩码（或CIDR前缀长度），自动计算网络地址、广播地址、可用IP地址范围、可用主机数量等子网信息。支持CIDR表示法（如192.168.1.0/24）和点分十进制子网掩码（如255.255.255.0）两种输入方式。子网划分是网络规划、数据中心设计、云计算VPC配置的基础知识。本工具适用于网络工程师规划IP地址分配、运维人员配置防火墙规则、开发者理解网络拓扑等场景，所有计算在浏览器本地完成。