JSON ve Veri Formatları: Sistemler Arasındaki Ortak Dil

İki farklı sistemin birbiriyle veri alışverişi yapabilmesi için ortak bir dile ihtiyacı vardır. Bir PHP uygulaması, bir mobil uygulama, bir JavaScript arayüzü ve bir Python servisi birbirinden tamamen farklı teknolojiler olabilir; ancak aralarında veri taşınması gerektiğinde, hepsinin anlayabileceği tarafsız bir formata başvururlar. Günümüzde bu ortak dilin adı büyük ölçüde JSON'dur. Bu yazıda JSON'un neden bu kadar yaygınlaştığını, yapısını ve doğru kullanımını inceleyeceğiz.

JSON Nedir ve Neden Bu Kadar Sevildi?

JSON (JavaScript Object Notation), insan tarafından okunabilir, makine tarafından kolayca ayrıştırılabilir bir veri değişim formatıdır. Adında JavaScript geçse de bugün her programlama dili onu destekler. Başarısının sırrı sadeliğidir: yalnızca birkaç temel yapıdan oluşur ve fazladan hiçbir gürültü içermez.

{
  "siparis_no": 1024,
  "musteri": "Ayse Yilmaz",
  "tutar": 349.90,
  "odendi": true,
  "kalemler": ["kalem", "defter", "silgi"]
}

Bu örnekte JSON'un tüm temel taşlarını görürsünüz: anahtar-değer çiftleri, sayılar, metinler, mantıksal değerler ve diziler. İç içe geçebilen bu basit yapılarla, en karmaşık veri bile temsil edilebilir.

JSON'un Temel Yapı Taşları

• Nesne (object): Süslü parantez içinde anahtar-değer çiftleri: { "ad": "Ali" }.
• Dizi (array): Köşeli parantez içinde sıralı değerler: [1, 2, 3].
• Metin (string): Çift tırnak içinde: "merhaba".
• Sayı (number): Tam veya ondalıklı: 42, 3.14.
• Mantıksal (boolean): true veya false.
• Boş değer: null.

JSON'un dehası, öğrenilecek neredeyse hiçbir şeyinin olmamasıdır. Bu birkaç yapı taşıyla, dünyadaki hemen her veriyi ifade edebilirsiniz.

JSON ile XML: Neden JSON Kazandı?

Bir zamanlar veri değişiminin standardı XML idi. XML güçlüdür ve hâlâ birçok kurumsal sistemde (özellikle e-fatura gibi alanlarda) kullanılır. Ancak JSON, web dünyasında onu büyük ölçüde geride bıraktı. Nedeni, ayný veriyi çok daha az yer kaplayarak ve çok daha okunabilir biçimde ifade etmesidir.

Aynı sipariş bilgisini XML ile yazsaydık, her alan için açılış ve kapanış etiketleri gerekir, dosya belirgin biçimde şişerdi. JSON'da bu tekrar yoktur; veri kendi kendini açıklar. Yine de XML'in üstün olduğu durumlar vardır: karmaşık belge yapıları, şema doğrulama gelenekleri ve belirli sektörel standartlar hâlâ XML'e dayanır. Doğru format, kullanım bağlamına göre seçilir.

• JSON tercih edilir: Web API'leri, mobil uygulama iletişimi, yapılandırma dosyaları.
• XML tercih edilir: Belge odaklı yapılar, e-fatura, bazı kurumsal ve sektörel standartlar.

PHP ile JSON Kullanımı

PHP, JSON ile çalışmayı iki temel fonksiyonla son derece kolaylaştırır. Veriyi JSON'a çevirmek için json_encode, JSON'u PHP dizisine dönüştürmek için json_decode kullanılır:

$veri = ['ad' => 'Ali', 'yas' => 30];
$json = json_encode($veri, JSON_UNESCAPED_UNICODE);

$geriDonusum = json_decode($json, true);
echo $geriDonusum['ad']; // Ali

Türkçe karakterlerin doğru görünmesi için JSON_UNESCAPED_UNICODE bayrağını kullanmak, Türkiye'deki projelerde küçük ama önemli bir ayrıntıdır. Ayrıca json_decode sonrası json_last_error() ile ayrıştırmanın başarılı olup olmadığını kontrol etmek, sağlam kod yazmanın gereğidir.

İyi Uygulamalar ve Sık Hatalar

JSON basit olsa da, veri değişiminde bazı ilkelere uymak sistemlerin uzun vadede sağlıklı konuşmasını sağlar:

1. Tutarlı isimlendirme: Tüm anahtarlarınızda aynı stili kullanın; karışık isimlendirme entegrasyonu zorlaştırır.
2. Tarihleri standart formatta verin: ISO 8601 (2025-11-15T14:30:00Z) uluslararası standarttır ve belirsizlik bırakmaz.
3. Sayıları metin olarak göndermeyin: Tutarlar için gerçek sayı tipi kullanın, tırnak içinde metin değil.
4. Doğrulama yapın: Gelen JSON'un beklediğiniz yapıda olduğunu şema (JSON Schema) ile kontrol etmek, hatalı veriyi baştan yakalar.
5. Fazla veri göndermeyin: Yalnızca gereken alanları taşıyın; büyük ve gereksiz gövdeler performansı düşürür.

Veri formatı, iki sistem arasındaki sözleşmedir. Tutarsız bir JSON yapısı, iki tarafın da birbirini yanlış anlamasına açık kapı bırakır.

Veri Formatı Seçiminin Önemi

Doğru veri formatı, bir entegrasyonun başarısını doğrudan etkiler. JSON'un sadeliği çoğu web tabanlı senaryoda idealdir; ancak çok büyük veri hacimlerinde ya da katı şema gereksinimlerinde başka formatlar (örneğin Protocol Buffers ya da XML) daha uygun olabilir. Önemli olan, formatı ihtiyaca göre bilinçli seçmek ve tarafların üzerinde net bir sözleşmeyle anlaşmasıdır.

Berasoft olarak geliştirdiğimiz sistemlerde, dışa açılan API'ler ve entegrasyonlarda JSON'u tutarlı ve iyi belgelenmiş bir sözleşmeyle sunmaya özen gösteririz; çünkü bugün net tanımlanan bir veri yapısı, yarınki entegrasyonların en sağlam zeminidir.

Sonuç

JSON, sistemlerin birbirini anlaması için ortaya çıkmış sade ve güçlü bir ortak dildir. Birkaç temel yapı taşıyla neredeyse her veriyi ifade eder, her programlama dili tarafından desteklenir ve okunması kolaydır. XML gibi köklü alternatiflerin hâlâ yeri olsa da, web dünyasının varsayılan dili artık JSON'dur. Onu tutarlı isimlendirme, doğru veri tipleri, standart tarih formatları ve doğrulama ile kullandığınızda, sistemleriniz arasındaki iletişim hem güvenilir hem de anlaşılır olur.