Trình xem OpenAPI / Swagger

Hiển thị tài liệu OpenAPI 3.0 / 3.1 hoặc Swagger 2.0 (YAML hoặc JSON) thành tham chiếu API có thể duyệt — thông tin, máy chủ, path theo thẻ, tham số, ví dụ thân yêu cầu sinh từ schema, phản hồi và bảo mật. Mở rộng bất kỳ thao tác nào để Thử và gửi yêu cầu trực tiếp từ trình duyệt, hoặc xuất dưới dạng cURL. Tài liệu được phân tích cục bộ; các đích $ref từ xa và schema bên ngoài không được tải về (hoàn toàn cục bộ). Muốn trình soạn yêu cầu tương tác thay thế? Xem REST API Client / Tester và toàn bộ nhóm Công cụ API.
Tài liệu OpenAPI / Swagger
Thử
Tham số
Về trình xem này: hỗ trợ Swagger 2.0 và OpenAPI 3.0 / 3.1. Tham chiếu được phân giải chỉ bên trong tài liệu (#/components/schemas/…, #/definitions/…); tham chiếu tệp ngoài / URL được báo cáo chứ không được tải về. Các lệnh Thử phụ thuộc vào chính sách CORS của máy chủ đích — nếu lệnh bị chặn, hãy dùng Bộ chuyển đổi cURL hoặc REST Client để chạy từ bên ngoài sandbox của trình duyệt.
OpenAPI so với Swagger, v2 so với v3

Swagger là tên công cụ ban đầu; khi đặc tả được trao cho Linux Foundation năm 2015 nó trở thành OpenAPI, còn Swagger tồn tại như một thương hiệu công cụ. Một tài liệu được xây từ info (siêu dữ liệu), paths (thao tác theo từng endpoint) và components (schema tái sử dụng).

Khóa phiên bản cho người xem biết dùng trình phân tích nào: swagger: "2.0" so với openapi: 3.0.x — v3 chuyển thân yêu cầu ra khỏi tham số và áp dụng JSON Schema thực thụ.