ESC

JSON Şema Oluşturucu

%100 istemci taraflı. JSON verileriniz tarayıcınızdan asla çıkmaz.

Kullanım Örnekleri

Koşullu şemalar ve içerik kodlama gibi en yeni özellikler için Draft-07 kullanın.

Zorunlu alanların katı doğrulaması gerektiğinde "Tüm alanları zorunlu olarak işaretle" seçeneğini etkinleştirin.

Oluşturulan şemayı indirip otomatik CI doğrulaması için projenize ekleyin.

Belgelendirmeniz için hızlıca şema oluşturmak üzere örnek bir API yanıtı yapıştırın.

JSON Schema Types

Supported JSON Schema data types:

  • string - Text values
  • number - Decimal numbers
  • integer - Whole numbers
  • boolean - true/false
  • array - Ordered lists
  • object - Key-value pairs
  • null - Null value

Özellikler

Otomatik Şema Oluşturma

Herhangi bir JSON yapıştırın; türler, biçimler ve yapı otomatik olarak algılansın

Şema Doğrulama

JSON verisini herhangi bir şemaya göre doğrulayın ve uyuşmazlıklar için ayrıntılı hata mesajları görün

Çoklu Taslak Sürümleri

Proje gereksinimlerinize uygun Draft-04, Draft-06 ve Draft-07 desteği

Gizli ve Çevrimdışı

Tamamen tarayıcınızda çalışır, hiçbir JSON verisi sunucuya gönderilmez

Nasıl Kullanılır

1

JSON Yapıştırın

JSON verinizi giriş alanına yapıştırın veya hazır örneklerden birini deneyin.

2

Seçenekleri Ayarlayın

Taslak sürümünü seçin ve zorunlu alanlar ile ek özellikler gibi seçenekleri ayarlayın.

3

Oluşturun veya Doğrulayın

Şema oluşturmak için Şema Oluştur'a tıklayın veya Doğrula sekmesine geçerek JSON'ı bir şemaya göre kontrol edin.

Sıkça Sorulan Sorular

JSON Schema, JSON belgelerini tanımlamak ve doğrulamak için kullanılan bir sözlüktür. JSON'unuzun beklenen yapısını, veri tiplerini, zorunlu alanları ve kısıtlamalarını tanımlar. Bir şema belgesiin kendisi de bir JSON'dur; API payload'larını, form girişlerini, yapılandırma dosyalarını veya veritabanı kayıtlarını otomatik doğrulamak için kullanılabilir. OpenAPI/Swagger spesifikasyonlarının temelini oluşturur ve veri sözleşmesi testleri için CI boru hatlarında yaygın olarak kullanılır.

Geçerli herhangi bir JSON'ı yapıştırın ve Generate Schema butonuna tıklayın. Araç, her özelliği özyinelemeli (recursive) olarak tarar, tipleri çıkarır (string, number, integer, boolean, null, object, array), yaygın metin formatlarını (date-time, email, URI, UUID) algılar ve eksiksiz bir şema ağacı üretir. Seçenekler sayesinde tüm alanları zorunlu olarak işaretleyebilir, ek özelliklere izin vermeyebilir veya dokümantasyon için açıklama yer tutucuları ekleyebilirsiniz.

Çoğu proje için doğru seçim Draft-07'dir; en yaygın desteklenen sürümdür ve if/then/else koşulları ile içerik kodlama anahtar kelimeleri gibi özellikler ekler. Draft-06, "const" ve "contains" özelliklerini tanıttı. Draft-04 en eski sürümüdür ve yalnızca belirli bir araç (eski doğrulayıcılar, bazı Swagger 2.0 araçları) bunu açıkça gerektirdiğinde kullanılmalıdır. Şüpheniz varsa Draft-07'yi kullanın.

Evet. Validate sekmesine geçin, sol panele JSON verinizi ve sağ panele şemanızı yapıştırın, ardından Validate butonuna tıklayın. Araç tam doğrulamayı çalıştırır ve her hatayı alan yolu ve ihlal açıklamasıyla birlikte rapor eder. Bu sayede bir API'den gelen, bir form gönderimi veya bir yapılandırma dosyasından alınan JSON'u sadece bu araçla oluşturulan şemalara karşı değil, herhangi bir şemaya karşı kontrol edebilirsiniz.

"required" anahtar kelimesi, JSON içinde bulunması zorunlu olan alanları listeler. "Mark all fields as required" seçeneğini etkinleştirdiğinizde, örnek JSON'unuzda bulunan her anahtar zorunlu dizisine eklenir. Uygulamada, genellikle üretimden sonra bu listeyi düzenleyerek gerçekten isteğe bağlı olan anahtarları çıkarırsınız. Bir alanın zorunlu olması, o anahtar mevcut değilse doğramanın başarısız olacağı anlamına gelir; alanın değerinin null olmadığını ifade etmez.

Şemada additionalProperties false olarak ayarlandığında, doğrulama properties nesnesinde tanımlanmayan anahtarlar içeren herhangi bir JSON'u reddeder. Bu, alan adlarındaki yazım hatalarını yakalamak istediğiniz veya istemcilerin tanımlanmamış alanlar göndermesini engellemek istediğiniz katı API sözleşmeleri için yararlıdır. Bunu true olarak bırakmak (veya atlamak) doğrulama hataları olmadan herhangi bir ek alana izin verir — ileri uyumlu şemalar için daha iyidir.

Şemayı indirin veya kopyalayın, ardından bir doğrulama kütüphanesi kullanın: Ajv (JavaScript/Node.js), jsonschema veya jsonschema-rs (Python/Rust), Newtonsoft.Json.Schema (C#) veya NetworkNT JSON Schema Validator (Java). Ajv'de: const validate = ajv.compile(schema); const valid = validate(data). Şema dosyası ayrıca otomatik oluşturulan dokümantasyon için OpenAPI spesifikasyonlarında components/schemas altında referans gösterilebilir.

Evet. Bu araç %100 tarayıcınızda çalışır. JSON verileriniz asla herhangi bir sunucuya gönderilmez, saklanmaz veya günlüğe kaydedilmez. Kimlik bilgileri içeren API yanıtları, dahili yapılandırma dosyaları veya herhangi bir hassas veri ile güvenle kullanabilirsiniz.

JSON Şema Oluşturucu Nedir?

JSON Şema Oluşturucu, örnek JSON verisinden otomatik olarak JSON Schema tanımı oluşturur. Şema tanımlarını elle yazmak yerine JSON'ınızı yapıştırırsınız ve araç türleri, yapıları, iç içe nesneleri ve dizileri algılayarak geçerli bir şema belgesi üretir. Bu, saatlerce sürecek manuel çalışmayı ortadan kaldırır ve şema tanımlarındaki hata olasılığını azaltır.

Nasıl Çalışır

Oluşturucu, JSON girişinizi ayrıştırır ve her özelliği özyinelemeli olarak inceler. Veri türlerini (string, number, integer, boolean, null, object, array) algılar, tarih ve e-posta gibi dize biçimlerini tanır ve eksiksiz bir şema ağacı oluşturur. Zorunlu alanlar, ek özellikler ve açıklama yer tutucuları gibi seçeneklerle çıktıyı özelleştirebilirsiniz. Her şey tarayıcınızda istemci tarafında çalışır.

Yaygın Kullanım Alanları

Geliştiriciler JSON Şema oluşturucularını REST API belgelendirme, yapılandırma dosyası doğrulama, mikro hizmetler arasında veri sözleşmesi uygulama ve form doğrulayıcıları oluşturma için kullanır. Gerçek API yanıtlarından oluşturulan şemalar, CI süreçlerinde otomatik olarak test edilebilen canlı belgeler olarak hizmet eder. Ayrıca OpenAPI ve Swagger spesifikasyonları için de gereklidirler.

Gizlilik ve Güvenlik

Bu JSON Şema Oluşturucu tamamen istemci taraflıdır. Tüm ayrıştırma, şema oluşturma ve doğrulama işlemleri JavaScript kullanılarak tarayıcınızda gerçekleşir. Hiçbir JSON verisi herhangi bir sunucuya gönderilmez. Girişlerinizi izleyen çerez yoktur ve mevcut oturumunuzun ötesinde hiçbir şey saklanmaz. Özel API'ler, dahili yapılandırmalar ve hassas verilerle güvenle kullanabilirsiniz.

Güvenlik ve Gizlilik

Verilerinizin güvenliği bizim önceliğimiz

Yerel İşleme

Tüm işlemler tarayıcınızda gerçekleşir

Veri Transferi Yok

Verileriniz sunucularımıza gönderilmez

Veri Depolama Yok

Hiçbir veri depolanmaz veya paylaşılmaz

SSL Şifreleme

Güvenli bağlantı için SSL şifreleme

MoreOnlineTools'ta Daha Fazlası