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
Dán tài liệu JSON của OpenAPI 3.0 hoặc Swagger 2.0 vào khung soạn thảo.
Hệ thống tự động phân tích cú pháp và chạy bộ kiểm tra toàn diện.
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.
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
3 operations
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:
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.
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ụ.
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
Khám Phá Lược Đồ & Kiểm Thử Truy Vấn GraphQL (GraphQL Schema Explorer)
Phân tích lược đồ GraphQL SDL, kiểm tra tính hợp lệ của schema và đối chiếu câu truy vấn (Query)
Tra Cứu Mã Trạng Thái HTTP (HTTP Status Code Reference)
Tra cứu ý nghĩa, nguyên nhân và cách khắc phục mọi mã phản hồi HTTP từ 1xx đến 5xx & Cloudflare
Tạo Schema JSON-LD Chuẩn SEO (Schema.org)
Tạo nhanh thẻ `<script type="application/ld+json">` cho FAQPage, Article, Product, SoftwareApplication & BreadcrumbList ngay trên trình duyệt