Inspector external $ref URL’lerini fetch ediyor mu?
Hayır. External reference ve doküman path’i network isteği yapılmadan kaydedilir. Böylece private spec adresleri veya credential bilgileri dışarı çıkmaz.
OpenAPI & Swagger Inspector
OpenAPI 3.0, OpenAPI 3.1 veya Swagger 2.0 operation, schema, security scheme, server ve reference yapılarını remote fetch yapmadan inceleyin.
Yerel girdi limiti: 5 MB · İşleme zaman aşımı: 120 sn
Bunu nasıl doğrulayabilirim?
Tarayıcınızın DevTools ekranında Network panelini açın, isterseniz mevcut istekleri temizleyin ve aracı çalıştırın. Sayfa dosyaları veya izin verilen analytics istekleri görülebilir; fakat araç payload’ları, dosyalar, anahtarlar ve sonuçlar işlenmek için gönderilmez.
OpenAPI veya Swagger dokümanını inceleyin
JSON/YAML yapıştırın ya da local spec dosyası seçin. External $ref adresleri raporlanır fakat otomatik olarak istek atılmaz.
0 KB
Spec envanteri
Spec envanteri burada gösterilecek
Bir spec yapıştırın veya örneği yükleyin; operation, schema, security, server ve reference yapılarını inceleyin.
API spec envanteri
DecodeLens tanımlanan API yapısını listeler ve limitli yapısal diagnostic üretir. Official OpenAPI conformance schema veya runtime request validation yerine geçtiğini iddia etmez.
İnceleme sınırları
- Version alanı bulunan OpenAPI 3.0.x, OpenAPI 3.1.x ve Swagger 2.0 JSON/YAML dokümanları desteklenir.
- Internal JSON Pointer $ref değerleri local olarak kontrol edilir. External dosya ve URL reference’ları listelenir fakat otomatik fetch yapılmaz.
- OpenAPI 3.1 component schema’ları Draft 2020-12 validation’a aktarılabilir. OpenAPI 3.0 ve Swagger 2.0 schema dialect’i farklı olduğu için inspector’da kalır.
- Yapısal diagnostic’ler yaygın doküman, operation, parameter, response, operationId ve reference sorunlarını kapsar; eksiksiz spec uyumluluğu iddia etmez.
- Bu versiyonda server request, operation çalıştırma, remote schema lookup, authentication flow veya HAR validation yapılmaz.
Bu işle birlikte kullanabileceğiniz araçlar
Aynı veriyi decode etmek, dönüştürmek, incelemek veya doğrulamak için ilgili araçlarla devam edin.
- Veri formatları
JSON Schema Validator
JSON verisini Draft 7, 2019-09 veya 2020-12 schema ile validate edin; instance path, satır, sütun, schema keyword ve Object View sonuçlarını inceleyin.
Aracı aç - Veri formatları
JSON ↔ YAML Converter
JSON ve YAML arasında dönüşüm yapın; syntax hatalarını bulun ve sonucu Object View ile inceleyin.
Aracı aç - API ve network
HAR File Analyzer & Sanitizer
HAR request, hata, timing, transfer, body ve hassas alanlarını analiz edin; ayrı bir redacted kopya oluşturun.
Aracı aç - Veri formatları
JSON Formatter & Validator
JSON’u formatlayın, minify edin ve validate edin; iç içe verilerde Object View ile gezinin.
Aracı aç
API contract’ını inceleyin
Local spec’i yükleyin, operation’ları filtreleyin, reusable schema ve security tanımlarını inceleyin; entegrasyon veya code generation öncesinde unresolved/external reference’ları kontrol edin.
OpenAPI dokümanı
openapi: 3.1.0
info:
title: Pet API
version: 1.0.0
paths: {}Envanter
OpenAPI 3.1.0 · 0 operation · 0 unresolved $refOpenAPI & Swagger Inspector SSS
Bu araç tam bir OpenAPI validator mı?
Hayır. Faydalı ve limitli yapı kontrolleri yapar, contract envanteri çıkarır. Her OpenAPI schema kuralı için eksiksiz conformance iddia etmez.
Neden yalnızca OpenAPI 3.1 schema’ları JSON Schema Validator’a açılıyor?
OpenAPI 3.1 Schema Object modern JSON Schema ile uyumludur. OpenAPI 3.0 ve Swagger 2.0 farklı dialect kullanır ve Draft 2020-12 olarak etiketlenmemelidir.
Spec upload ediliyor mu?
Hayır. Parse, reference kontrolü ve envanter disposable browser worker içinde çalışır.