JSON çevrimiçi nasıl biçimlendirilir: güzelleştirme, doğrulama ve hata düzeltme

Bir API’den JSON yanıtını kopyalayıp düzenleyicinize yapıştırırsınız ve hiçbir boşluk olmadan, tek bir uzun ve kesintisiz metin satırıyla karşılaşırsınız. O karakter duvarının bir yerinde ihtiyacınız olan değer gizlidir, ama onu gözle okumak neredeyse imkânsızdır. JSON’ı biçimlendirmek tam olarak bunu çözer. Bu rehber, JSON güzelleştirme ve doğrulamanın aslında ne yaptığını ve ücretsiz JSON Biçimlendirici aracının dağılmış verileri okuyabileceğiniz bir şeye nasıl dönüştürdüğünü açıklıyor.

Biçimlendirme ve doğrulama ne anlama gelir

Bunlar, iyi araçların birlikte yaptığı iki ayrı iştir.

Biçimlendirme (güzelleştirme veya düzgün yazdırma olarak da bilinir) verinin yapısının görünür olması için satır sonları ve girinti ekler. İç içe geçmiş nesneler içeriye kayar, diziler hizalanır ve her anahtar kendi satırında durur. Veri hiç değişmez, yalnızca sunumu değişir.

Doğrulama, metnin ilk etapta geçerli bir JSON olup olmadığını kontrol eder. JSON’ın katı kuralları vardır: anahtarlar çift tırnak içinde olmalı, dizeler tek tırnak kullanamaz ve yorum satırları yoktur. Bir doğrulayıcı, belgenin ayrıştırılıp ayrıştırılmadığını ve ayrıştırılmıyorsa nerede bozulduğunu size söyler.

Genellikle her ikisini de istersiniz. Okumak için biçimlendirin, güvenmek için doğrulayın.

Küçültülmüş JSON neden okunamaz

Sunucular arasında gönderilen JSON neredeyse her zaman küçültülmüştür, yani her isteğe bağlı boşluk ve satır sonu kaldırılmıştır. Bu, makineler için iyidir: daha küçük yükler daha hızlı ilerler ve daha az bant genişliği tüketir. İnsanlar için ise korkunçtur.

Küçültülmüş bir nesne şöyle görünür: {"user":{"id":42,"roles":["admin","editor"],"active":true}}. Bu, yönetilebilir. Ama gerçek bir API yanıtı, beş seviye derinliğine iç içe geçmiş nesnelerle, tek bir satırda binlerce karakter uzunluğunda olabilir. Girinti olmadan bir nesnenin nerede bitip diğerinin nerede başladığını anlayamazsınız ve bir kapanış süslü parantezini açanla eşleştirmek tahmin yürütmeye dönüşür. Biçimlendirme, verinin şekli ekranınızdaki şekille örtüşecek biçimde görsel hiyerarşiyi geri getirir.

Yaygın sözdizimi hatalarını yakalama

JSON sorunlarının çoğu az sayıdaki küçük hatadan kaynaklanır. Bir doğrulayıcı, bu hataların ileride bir yerde sessizce başarısız olmasına izin vermek yerine onları anında yakalar. Şunlara dikkat edin:

• Sondaki virgüller. Bir nesne veya dizide son ögeden sonra gelen bir virgül, {"a":1,} gibi, JavaScript’te geçerlidir ama JSON’da geçersizdir.
• Tek tırnaklar. JSON çift tırnak gerektirir. {'name':'Sam'} ayrıştırılmaz.
• Anahtarlarda eksik tırnaklar. Her anahtar tırnak içinde olmalıdır: {name:"Sam"} geçersizdir.
• Kaçış karakteri uygulanmamış karakterler. Bir dize içindeki işlenmemiş satır sonu veya kaçış karakteri uygulanmamış bir tırnak ayrıştırmayı bozar.
• Eşleşmeyen parantezler. Eksik tek bir } veya ], tüm belgeyi rayından çıkarır.

JSON Biçimlendirici bir hata bildirdiğinde, size verdiği konumu okuyun ve tam o noktanın öncesine bakın. Gerçek hata çoğu zaman ayrıştırıcının sonunda pes ettiği yerden bir karakter öncesindedir.

API yanıtlarını güvenle okuma

Bir entegrasyonda hata ayıklarken, bir uç noktanın gerçekte ne döndürdüğünü anlamanın en hızlı yolu biçimlendirmedir. Ham yanıtı yapıştırın, güzelleştirin ve hangi alanların var olduğunu, bir listenin boş mu döndüğünü ve iç içe geçmenin ne kadar derin olduğunu hemen görebilirsiniz. Bu, müphem bir “veri yanlış görünüyor” ifadesini kesin bir “items dizisinde price alanı eksik” ifadesine dönüştürür.

JSON Biçimlendirici ücretsiz olduğu, kayıt gerektirmediği ve tamamen tarayıcınızda çalıştığı için, yapıştırdığınız yanıt cihazınızdan asla ayrılmaz. Bir yük; belirteçler, e-posta adresleri veya yalnızca okumak için rastgele bir sunucuya yüklemek istemeyeceğiniz başka herhangi bir şey içerdiğinde bu önemlidir.

İlişkili biçimlerle çalışmak

JSON nadiren tek başına yaşar ve biçimler arasında dönüştürme yaygın bir sonraki adımdır. Bir hesap tablosu dışa aktarmasında verileriniz varsa ve bunları yapılandırılmış JSON olarak istiyorsanız, CSV’den JSON’a dönüştürücü satırları ve sütunları, doğrudan kodunuza bırakabileceğiniz nesnelere dönüştürür. Eski bir sistemden veya bir SOAP servisinden veri çıkarıyorsanız, XML’den JSON’a dönüştürücü etiketleri temiz anahtar-değer çiftlerine yeniden şekillendirir. Ve bir JSON alanı kodlanmış bir blok tuttuğunda, Base64 Kodlama ve Çözme aracı bunu çözer, böylece içinde gerçekte ne olduğunu görebilirsiniz.

Kısa özet

Biçimlendirme, girintiyi geri getirerek JSON’ı okunabilir kılar ve doğrulama, ona güvenmeden önce belgenin gerçekten geçerli olduğunu teyit eder. Birlikte, küçültülmüş ve hataya yatkın bir dizeyi, güvenebileceğiniz ve üzerinde düşünebileceğiniz bir şeye dönüştürürler. Bir dahaki sefere bir API size okunamaz bir metin satırı verdiğinde, onu JSON Biçimlendirici içine yapıştırın, güzelleştirmesine ve yapıyı kontrol etmesine izin verin ve verilerinizi okunması gerektiği şekilde okuyun.