JSON nedir? Biçim, doğrulama ve yaygın hatalar

JSON neyi temsil eder?

JSON bir veri değişim biçimidir; tek başına programlama dili veya veritabanı değildir. Nesne, dizi, metin, sayı, doğru/yanlış ve null değerlerini temsil eder. RFC 8259 biçimin yaygın kurallarını tanımlar.

Örneğin { "name": "Ada", "active": true } bir kullanıcı kaydını taşıyabilir. Farklı dillerdeki uygulamalar aynı metni okuyabilir.

Sözdizimi kuralları

Nesnelerde alan adları çift tırnakla yazılır; alan adı ile değer arasında iki nokta, alan çiftleri arasında virgül bulunur. Son elemandan sonra fazladan virgül geçersizdir. Diziler köşeli parantez kullanır.

JSON yorum satırlarını, fonksiyonları ve undefined değerini desteklemez. Tarihler de yerleşik tür değildir; genellikle standart metin biçiminde aktarılır ve uygulamada dönüştürülür.

Doğrulama ve hata ayıklama

Bir ayrıştırıcı sözdizimini kontrol eder ama verinin iş açısından doğru olduğunu kanıtlamaz. Örneğin negatif fiyat geçerli JSON olabilir; iş kuralını ihlal edip etmediği ayrı doğrulanır.

Hata konumunun çevresinde tırnak, virgül ve kapatma parantezlerini inceleyin. Üretim verisi yerine örnek veya maskeli veri kullanın.

JSON ve JavaScript nesnesi

JSON JavaScript nesne gösterimine benzese de daha katıdır. JavaScript’te {name: "Ada"} yazılabilir; standart JSON’da anahtar çift tırnaklı olmalıdır: { "name": "Ada" }.

API yanıtını uygulama modeline çevirmeden önce alan tiplerini, eksik değerleri ve şema sürümünü kontrol edin.

JSON nesnelerini düzenli okuma

İç içe veride önce en dıştaki nesne veya diziyi bulun, sonra alanları girintiye göre izleyin. Bir API yanıtında üst düzey durum alanı, kayıt listesi ve her kaydın ayrıntıları ayrı katmanlarda olabilir. Biçimlendirme yalnız görünümü değiştirir; alanların sırasını anlamlı iş kuralı sanmayın. Bazı sistemler yinelenen nesne anahtarlarını farklı ele alabilir, bu nedenle aynı nesne içinde aynı alan adını iki kez kullanmayın. Uzun yanıtı incelerken gizli veya kişisel değerleri paylaşmadan önce maskeleyin. JSON Formatter ile düzenleyip, beklenen alan türlerini uygulamanızın şemasına göre ayrıca kontrol edebilirsiniz.

JSON şeması ve doğrulama farkı

Sözdizimi doğrulaması metnin JSON olarak ayrıştırılıp ayrıştırılamadığını söyler. Şema veya uygulama doğrulaması ise hangi alanların zorunlu olduğunu, sayı mı metin mi beklediğinizi ve değer aralıklarını tanımlar. Örneğin yaş alanı geçerli bir JSON metninde metin olarak gelebilir; ayrıştırıcı buna itiraz etmese bile uygulamanız sayı bekliyorsa tip uyuşmazlığı vardır. Üretimde hem biçim doğrulaması hem de iş kurallarına yönelik kontroller gerekir. İstemciden gelen veriyi güvenilir saymayın; sunucu tarafındaki doğrulamayı atlamayın. JSON Schema kullandığınızda şema sürümünü API sözleşmenizde açıkça belirterek istemci ve sunucunun aynı kuralları uygulamasını kolaylaştırın.

API yanıtını güvenli biçimde paylaşma

Hata ayıklama için örnek yanıt paylaşırken erişim belirteçlerini, e-posta adreslerini, müşteri kimliklerini ve oturum çerezlerini çıkarın. Gerçek üretim kaydını doğrudan bir çevrimiçi araca kopyalamak yerine alan isimlerini koruyan sentetik bir örnek oluşturun. Girdi boyutu çok büyükse yalnız hatayı gösterecek en küçük parçayı ayırın; böylece hem inceleme kolaylaşır hem de gereksiz veri yayılmaz. JSON çıktısını yeniden biçimlendirdikten sonra değişen tek şeyin boşluk ve satır düzeni olduğundan emin olun; bazı imza veya karşılaştırma süreçleri bayt düzeyinde aynı metni gerektirir. API istemcisi, uygulama doğrulaması ve JSON Formatter farklı amaçlara hizmet eder.

Sık rastlanan JSON hatalarını ayıklama

Eksik kapanış parantezi, tek tırnak kullanımı, tırnak içinde olmayan anahtar ve son elemana eklenen virgül yaygın sözdizimi sorunlarıdır. Hata konumu satır ve sütun olarak verildiğinde, işaretlenen karakterin hemen öncesini de inceleyin; parser hatayı ancak sonraki karakterde fark etmiş olabilir. Satır sonu ve kaçış karakterleri de özellikle uzun metin alanlarında önemlidir: ters eğik çizgi özel anlam taşır ve gerçek satır sonu JSON string içinde kaçırılmalıdır. Önce küçük bir örnekle ayrıştırmayı doğrulayın, sonra kalan kayıtları ekleyin. Bu yöntem hatanın hangi eklemeden sonra ortaya çıktığını belirlemeye yardım eder; aracı kullanmak verinin anlamını veya kaynak güvenilirliğini doğrulamaz.

Örnek iş akışı: API verisini inceleme

Bir ekip sipariş API’sinden hata aldığında önce yanıtın JSON olarak ayrıştırılıp ayrıştırılmadığını kontrol eder. Yanıtı güvenli bir test örneğine dönüştürür, müşteri adı ve sipariş numarası gibi değerleri maskeler, sonra JSON Formatter ile girintileyip eksik virgül veya kapanmayan parantezi arar. Sözdizimi doğruysa ekip şema beklentilerine geçer: `status` alanı belirli seçeneklerden biri mi, `items` dizi mi, toplam alanı sayı mı? Bu ikinci denetim uygulamaya veya schema validator’a aittir. Son olarak düzeltilen örnek API entegrasyon testine eklenir; üretim girdisinin kendisi herkese açık rapora kopyalanmaz. Böylece biçimlendirme, yapı doğrulama ve iş kuralı denetimi birbirine karıştırılmadan ilerler.