Microdeck.tools 100% Trên trình duyệt

Kiểm Tra & Xem Tài Liệu OpenAPI / Swagger (OpenAPI Validator & Viewer)

New

Công cụ kiểm tra tính hợp lệ và trực quan hóa tài liệu API đặc tả OpenAPI 3.0 và Swagger 2.0 dạng JSON: kiểm tra các trường dữ liệu bắt buộc (info, paths), kiểm tra tham số đường dẫn `{param}`, phát hiện operationId bị trùng lặp, mã phản hồi HTTP hợp lệ, kiểm tra các liên kết tham chiếu schema `$ref` bị gãy và lập danh mục chi tiết tất cả các API Endpoint.

100% Trên trình duyệt Không tải lên máy chủ Kết quả tức thì

Công cụ này có giúp bạn tiết kiệm thời gian không? Chung tay giữ Microdeck miễn phí và ổn định. Hoàn toàn tự nguyện · Từ $3.

Nguyên lý hoạt động

Trình phân tích cấu trúc OpenAPI quét toàn bộ cây đối tượng JSON: kiểm tra tính hợp lệ theo schema chuẩn của OpenAPI Initiative, truy vết tất cả các con trỏ JSON Pointer `$ref: "#/components/schemas/..."` để đảm bảo định nghĩa đích tồn tại, đồng thời trích xuất danh sách phương thức HTTP (GET, POST, PUT, DELETE) kèm mô tả.

Hướng dẫn từng bước

1

Dán tài liệu JSON của OpenAPI 3.0 hoặc Swagger 2.0 vào khung soạn thảo.

2

Hệ thống tự động phân tích cú pháp và chạy bộ kiểm tra toàn diện.

3

Xem bảng thông báo kết quả: Đạt tiêu chuẩn (Valid) hoặc danh sách chi tiết các lỗi cú pháp và cảnh báo.

4

Xem danh sách API Endpoints được gom nhóm theo Tag và Method kèm mã phản hồi HTTP.

Tính năng nổi bật & Hiệu năng

  • Hỗ trợ đầy đủ cả chuẩn OpenAPI 3.0 và Swagger 2.0
  • Truy vết và phát hiện các liên kết $ref bị đứt gãy (Broken schema references)
  • Kiểm tra tính nhất quán giữa tham số URL `{id}` và danh sách parameters
  • Giao diện duyệt API Endpoint gọn nhẹ, trực quan thay thế Swagger UI nặng nề

Phương pháp tính, Công thức & Tiêu chuẩn

Checks required fields, path parameters, duplicate IDs and references.

Ví dụ minh họa & Trường hợp biên

A pet shop API

Đầu vào
3 operations
Kết quả
No problems

Lưu ý về giới hạn & Độ chính xác

  • • JSON only; YAML is not read.
  • • Not a full schema validator.

Xử lý trực tiếp trên trình duyệt & Bảo mật

Các trang chuyển đổi thông thường tải tài liệu, mã nguồn hoặc video của bạn lên máy chủ từ xa. Kiểm Tra & Xem Tài Liệu OpenAPI / Swagger (OpenAPI Validator & Viewer) chạy hoàn toàn ngay trong tab trình duyệt của bạn:

Xử lý ngay tại tab này

Nội dung và tệp của bạn được tính toán ngay tại máy, không gửi lên bất kỳ máy chủ xử lý nào.

Không lưu nhật ký dữ liệu

Microdeck không ghi lại hay lưu trữ tệp và văn bản bạn dán vào công cụ.

Bộ nhớ tạm của trình duyệt

Kết quả làm việc chỉ nằm trong bộ nhớ tab hiện tại và tự giải phóng khi bạn đặt lại hoặc đóng tab.

Câu hỏi thường gặp (FAQ)

Lỗi gãy $ref trong OpenAPI thường do nguyên nhân gì?

Thường do bạn trỏ `$ref` tới một schema đã bị đổi tên, bị xóa hoặc sai đường dẫn JSON pointer (ví dụ trỏ vào `#/components/schemas/User` nhưng trong `components` lại không có đối tượng `User`).

Khám phá công cụ liên quan

Ủng hộ Microdeck

Hoàn toàn tự nguyện · Từ $3 · Không cần tài khoản

Chọn mức ủng hộ (USD):Đã chọn:$5

Mức ủng hộ tối thiểu là $3 USD.

Hoàn toàn tự nguyện · Từ $3 · Thanh toán qua Gumroad.