Minimal bir spesifikasyon
openapi: 3.0.0
info: {title: "Pet Store", version: "1.0"}
paths: {/pets: {get: {summary: "List pets"}}}Başlık "Pet Store" v1.0, bir uç nokta: GET /pets — List pets.
OpenAPI Görüntüleyici ve Doğrulayıcı
Uç noktalarını gezmek ve yapısal hataları yakalamak için bir OpenAPI veya Swagger spesifikasyonu yapıştırın.
Bu araç işinize yaradı mı?
Bu araç hakkında
Bir OpenAPI spesifikasyonu önce araçlar, sonra insanlar tarafından okunmak üzere tasarlanmıştır — bu araç bunu tersine çevirir, onu gezilebilir bir uç nokta listesi olarak render ederken, bir kod üreticisini sessizce bozan birkaç yapısal hatayı (eksik bir sürüm alanı, çözülemeyen bir $ref) işaretler.
Nasıl kullanılır
- Bir OpenAPI (3.x) veya Swagger (2.0) belgesini JSON veya YAML olarak yapıştırın.
- Ayrıştır'a basın. Varsa yapısal sorunlar önce listelenir.
- Her işlem, yol ve metoda göre gruplanmış olarak, parametreleriyle birlikte aşağıda listelenir.
Örnekler
Sık karşılaşılan sorunlar
- Tanımlı olduğundan emin olduğum bir $ref'i çözülemez olarak bildiriyor.
- Yalnızca #/components/schemas veya #/definitions altındaki aynı belge içi ref'ler kontrol edilir — ayrı bir dosyaya ya da standart dışı bir konuma giden bir $ref, tam bir araç zincirinde sorunsuz çözülse bile burada işaretlenir.