JSON Şeması Hakkında
JSON Şeması, JSON verilerinin yapısını ve içeriğini doğrulamak için kullanılan bildirimsel bir dildir. Geçerli JSON'un hangi şekle sahip olması gerektiğini — hangi alanların var olduğunu, hangi türleri içerdiğini, hangilerinin zorunlu olduğunu ve hangi ek kısıtlamaların geçerli olduğunu tanımlayan bir sözleşme görevi görür.
Bu Araç Ne Yapar?
JSON'dan JSON Schema'ya Dönüştürücü, JSON girişinizi analiz eder ve onu açıklayan bir şemayı otomatik olarak çıkarır. Herhangi bir JSON nesnesi veya dizisi yapıştırın ve belgeleme, doğrulama veya kod üretimi için kullanabileceğiniz geçerli bir şemayı anında elde edin.
Şema Seçenekleri
- Şema Başlığı: Kök şema nesnesine insan tarafından okunabilir bir başlık ekler. Şemanın diğer şemalarda veya araçlarda adıyla referans alınacağı durumlarda kullanışlıdır.
- JSON Şema Taslağı: Controls the $schema URI written into the output. Choose Draft-07 for maximum tool compatibility, or 2019-09 / 2020-12 for newer features like $defs and unevaluatedProperties.
- Zorunlu alanları ekle: When enabled, every key present in a JSON object is added to the schema's required array, meaning validators will reject objects that omit those keys.
- Ek özelliklere izin ver: When disabled (default), additionalProperties: false is added so validators reject any key not listed in properties. Enable this if the JSON objects in your system can carry arbitrary extra fields.
- Dize formatlarını çıkar: Attempts to detect well-known string formats — date-time, date, time, uuid, uri, email, and ipv4 — and annotates the schema property with a format keyword.
Yaygın Kullanım Senaryoları
- API doğrulaması: Ajv, Zod veya FastAPI gibi doğrulayıcıları kullanarak REST veya GraphQL API'lerinde istek ve yanıt gövdelerini doğrulayın.
- Kod üretimi: Şemayı TypeScript, Python, Go ve daha fazlasında yazılmış modeller oluşturmak için quicktype veya json-schema-to-typescript gibi araçlara besleyin.
- Belgeleme: İstek yüklerini ve yanıt şekillerini açıkça tanımlamak için OpenAPI spesifikasyonunuza bir JSON Şeması ekleyin.
- Yapılandırma doğrulaması: JSON yapılandırma dosyaları için otomatik tamamlama ve satır içi doğrulama sağlamak üzere şemayı VS Code gibi editörlerle kullanın.
- Veri boru hattı sözleşmeleri: Servisler veya ETL boru hattı aşamaları arasında akan verinin beklenen şeklini tanımlayın.
Türler Nasıl Çıkarılır
- JSON null → { "type": "null" }
- JSON booleans → { "type": "boolean" }
- Whole numbers → { "type": "integer" }, decimals → { "type": "number" }
- Strings → { "type": "string" } with optional format
- Arrays → { "type": "array", "items": {...} } where items is derived from all elements
- Objects → { "type": "object", "properties": {...} } with optional required and additionalProperties