JSON (JavaScript Object Notation), verileri anahtar-değer çiftleri ve listeler hâlinde saklayan, metin tabanlı hafif bir veri değişim formatıdır. Hem insanlar tarafından kolayca okunabildiği hem de programlar tarafından hızlıca işlenebildiği için web API’lerinde, mobil uygulamalarda, yapılandırma dosyalarında ve sunucular arası veri alışverişinde en yaygın kullanılan formattır. Bu rehberde JSON nedir, neden kullanılır, söz dizimi kuralları nelerdir ve XML ile CSV’den farkı ne, örneklerle anlatıyoruz.
JSON Nedir?
JSON, adını JavaScript’in nesne yazım biçiminden alır; ancak belirli bir programlama diline bağlı değildir. Python, PHP, Java, C#, Go ve diğer modern dillerin neredeyse tamamı JSON okuma ve yazma desteği sunar. Bu nedenle farklı dillerde yazılmış sistemler arasında ortak bir “veri dili” görevi görür.
Basit bir örnekle bir kullanıcının adı ve yaşı JSON formatında şöyle gösterilir:
{
"isim": "Ahmet",
"yas": 30
}
Süslü parantezler bir nesneyi, tırnak içindeki ifadeler anahtarları, iki noktanın sağındaki ifadeler de değerleri gösterir. JSON dosyaları genellikle .json uzantısıyla kaydedilir ve web üzerinde application/json içerik türüyle gönderilir.
JSON’un Kısa Tarihçesi
JSON, 2000’lerin başında Douglas Crockford tarafından tanımlanıp yaygınlaştırıldı. Crockford, JSON’u icat etmekten çok “keşfettiğini” söyler; çünkü format, JavaScript’te zaten var olan nesne yazımının sadeleştirilmiş bir alt kümesidir. Web sayfalarının sayfa yenilemeden sunucuyla veri alışverişi yaptığı AJAX tekniğiyle birlikte hızla benimsendi ve XML’in ağır yapısına göre pratik bir alternatif hâline geldi.
Bugün JSON iki resmî standartla tanımlanır: ECMA-404 ve IETF’in RFC 8259 belgesi. RFC 8259, ağlar arasında gönderilen JSON metninin UTF-8 ile kodlanmasını şart koşar.
JSON Neden Kullanılır?
- Okunabilir: Yapısı sade olduğu için bir geliştirici JSON dosyasını açıp içeriğini hemen anlayabilir.
- Hafif: XML’e göre daha az işaret içerir; aynı veri genellikle daha küçük boyutla iletilir.
- Dil bağımsız: Hemen her programlama dilinde hazır kütüphanelerle işlenir.
- Yapılandırılmış: İç içe nesneler ve listelerle karmaşık verileri düzenli şekilde temsil eder.
- Web ile uyumlu: Tarayıcılar JSON’u yerleşik fonksiyonlarla işler; ek bir dönüştürücüye gerek kalmaz.
JSON Söz Dizimi ve Kuralları
JSON’un kuralları azdır ama katıdır. Küçük bir yazım hatası bile dosyanın okunamamasına yol açar.
Temel Yapı Taşları
- Nesne (object): Süslü parantez { } içinde yer alan anahtar-değer çiftleri.
- Dizi (array): Köşeli parantez [ ] içinde, virgülle ayrılmış değerler listesi.
- Anahtar: Her zaman çift tırnak içinde yazılan metin.
- Ayırıcılar: Anahtar ile değer arasında iki nokta (:), çiftler arasında virgül (,).
{
"ad": "Merve",
"yas": 28,
"hobiler": ["sinema", "kitap okuma", "yoga"],
"aktif": true,
"adres": {
"sehir": "Ankara",
"ilce": "Çankaya"
},
"telefon": null
}
JSON Veri Tipleri
| Tip | Açıklama | Örnek |
|---|---|---|
| String (metin) | Çift tırnak içindeki karakterler | “merhaba dünya” |
| Number (sayı) | Tam sayı veya ondalıklı sayı | 42, 3.14 |
| Boolean | Doğru veya yanlış | true, false |
| Null | Değer yok | null |
| Object (nesne) | Anahtar-değer çiftlerinden oluşan yapı | {“a”: 1} |
| Array (dizi) | Sıralı değerler listesi | [“elma”, “muz”] |
Tarih, ikili dosya (resim, PDF) veya fonksiyon gibi tipler JSON’da doğrudan yoktur. Tarihler genellikle “2026-11-12” gibi metin olarak, ikili veriler ise Base64 ile kodlanmış metin olarak taşınır.
Sık Yapılan Söz Dizimi Hataları
- Tek tırnak kullanmak: JSON’da metinler ve anahtarlar yalnızca çift tırnakla yazılır.
- Son öğeden sonra virgül bırakmak: {“a”: 1,} geçersizdir.
- Yorum satırı eklemek: Standart JSON yorum satırını desteklemez.
- Tırnaksız anahtar yazmak: {ad: “Merve”} JavaScript’te çalışır ama geçerli JSON değildir.
- Undefined veya NaN kullanmak: Bu değerler JSON’da tanımlı değildir.
Bir JSON dosyasının geçerli olup olmadığını kontrol etmek için kod editörlerinin yerleşik doğrulayıcılarını veya çevrim içi JSON doğrulama araçlarını kullanabilirsiniz.
JSON ile Veri İşleme
JSON.parse: Metni Nesneye Çevirme
Sunucudan gelen JSON bir metindir; kullanılabilmesi için programlama dilinin nesnesine dönüştürülmesi gerekir. JavaScript’te bu iş JSON.parse() ile yapılır:
const jsonString = '{"ad": "Merve", "yas": 28}';
const kullanici = JSON.parse(jsonString);
console.log(kullanici.ad); // Çıktı: Merve
JSON.stringify: Nesneyi Metne Çevirme
Bir nesneyi sunucuya göndermek veya dosyaya kaydetmek için JSON.stringify() kullanılır:
const kullanici = { ad: "Merve", yas: 28 };
const jsonString = JSON.stringify(kullanici);
console.log(jsonString); // Çıktı: {"ad":"Merve","yas":28}
Okunabilir, girintili bir çıktı için JSON.stringify(kullanici, null, 2) şeklinde üçüncü parametreye boşluk sayısını yazabilirsiniz.
Diğer Dillerde JSON
- Python: Yerleşik json modülündeki json.loads() ve json.dumps() fonksiyonları
- PHP: json_decode() ve json_encode() fonksiyonları
- Java ve C#: Jackson, Gson veya System.Text.Json gibi kütüphaneler
JSON, XML ve CSV Karşılaştırması
JSON tek veri formatı değildir. Hangi formatın seçileceği, verinin yapısına ve kullanılacağı yere bağlıdır.
| Özellik | JSON | XML | CSV |
|---|---|---|---|
| Yapı | Nesne ve dizi, iç içe yapı | Etiket ağacı, öznitelikler | Düz tablo (satır ve sütun) |
| Okunabilirlik | Yüksek | Orta, etiketler kalabalık | Basit tablolarda yüksek |
| Boyut | Genellikle küçük | Genellikle daha büyük | En küçük |
| Şema ve doğrulama | JSON Schema ile | XSD, DTD ile köklü destek | Standart şema yok |
| Tipik kullanım | Web API, yapılandırma, mobil uygulama | Belge formatları, site haritası, RSS, kurumsal entegrasyon | Excel aktarımı, veri analizi, toplu içe aktarma |
JSON ve XML
Aynı veri iki formatta şöyle görünür:
{
"kullanici": {
"isim": "Ahmet",
"yas": 30
}
}
<kullanici>
<isim>Ahmet</isim>
<yas>30</yas>
</kullanici>
XML’de her değer açılış ve kapanış etiketi gerektirir; JSON’da ise yalnızca anahtar ve değer yazılır. XML; ad alanları, öznitelikler ve güçlü şema desteğiyle belge odaklı ve köklü kurumsal sistemlerde hâlâ yaygındır. Ayrıntılar için XML nedir yazımıza göz atabilirsiniz.
JSON ve CSV
CSV, verileri virgülle ayrılmış satırlar hâlinde saklar ve Excel gibi tablo programlarıyla doğrudan açılır. Düz tablolar için en pratik formattır ama iç içe veri taşıyamaz. Örneğin bir siparişin birden fazla ürün içerdiği durumda JSON, ürünleri tek kayıt altında bir dizi olarak saklayabilirken CSV’de her ürün için ayrı satır açmak gerekir.
JSON Nerelerde Kullanılır?
API’ler ve Web Servisleri
Günümüzde REST API’lerin büyük bölümü veriyi JSON olarak alıp gönderir. Bir hava durumu uygulaması sunucudan şu yanıtı alabilir:
{
"sehir": "Ankara",
"sicaklik": 20,
"durum": "Parçalı bulutlu"
}
API’lerin nasıl çalıştığını API nedir yazımızda ayrıntılı olarak anlattık. WordPress’in REST API’si de yazı, sayfa ve kullanıcı verilerini JSON formatında sunar.
Web Uygulamaları ve AJAX
Arama kutusunda yazarken çıkan öneriler, sepete ekle butonuna bastığınızda sayfanın yenilenmeden güncellenmesi gibi işlemler genellikle tarayıcı ile sunucu arasında JSON alışverişiyle gerçekleşir. Adında XML geçse de AJAX işlemlerinde bugün çoğunlukla JSON kullanılır.
Yapılandırma Dosyaları
JavaScript projelerindeki package.json, PHP projelerindeki composer.json ve birçok editörün ayar dosyası JSON formatındadır. Bazı araçlar yorum satırına izin veren JSONC veya daha esnek JSON5 gibi türevleri de destekler.
SEO ve Yapılandırılmış Veri (JSON-LD)
Arama motorlarına sayfanızdaki ürün, işletme, makale veya SSS bilgilerini anlatan yapılandırılmış veriler JSON-LD formatında yazılır. Google, yapılandırılmış veriler için JSON-LD’yi önerilen format olarak belirtir. Konuyu JSON-LD kodu nedir yazımızda örneklerle inceleyebilirsiniz.
Mobil Uygulamalar ve IoT
iOS ve Android uygulamaları sunucuyla iletişimde, çevrimdışı veri saklamada ve ayar dosyalarında JSON’u yaygın olarak kullanır. Sensörlerden veri gönderen akıllı cihazlarda da JSON tercih edilen formatlardan biridir; bu alanı IoT nedir yazımızda ele aldık.
Yapay Zekâ ve Veri Projeleri
Yapay zekâ modellerine gönderilen istekler ve alınan yapılandırılmış yanıtlar çoğunlukla JSON ile taşınır. Büyük veri setleri ise her satıra bir JSON nesnesi yazılan JSON Lines (NDJSON) formatında saklanabilir.
JSON’un Avantajları ve Sınırlılıkları
Avantajlar
- Hafif yapısı sayesinde ağ üzerinden hızlı iletim
- İnsanlar ve makineler için kolay okunabilirlik
- Neredeyse tüm programlama dillerinde yerleşik veya hazır destek
- İç içe nesne ve dizilerle esnek veri modelleme
Sınırlılıklar
- Yorum desteği yok: Yapılandırma dosyalarında açıklama yazmak zorlaşır.
- Sınırlı veri tipi: Tarih ve ikili veri için ek dönüşüm gerekir.
- Şema zorunlu değil: Veri yapısını doğrulamak için JSON Schema gibi ek araçlar gerekir.
- Çok büyük dosyalar: Dosyanın tamamını belleğe yüklemek performans sorununa yol açabilir; akış (streaming) tabanlı okuma veya JSON Lines tercih edilebilir.
Güvenlik
JSON’un kendisi bir güvenlik açığı değildir; riskler verinin nasıl işlendiğinden kaynaklanır. Dışarıdan gelen JSON’u asla eval() ile çalıştırmayın, her zaman JSON.parse() gibi güvenli ayrıştırıcılar kullanın. Kullanıcıdan gelen verileri sayfada göstermeden önce temizleyin (XSS’e karşı), API isteklerinde kimlik doğrulama ve CSRF önlemlerini uygulayın, beklenmeyen alanları ve aşırı büyük istekleri reddedin.
JSON Schema ile Veri Doğrulama
Bir API’ye gelen verinin beklenen yapıda olup olmadığını kontrol etmek için JSON Schema kullanılır. JSON Schema, kendisi de JSON ile yazılan bir kurallar bütünüdür: hangi alanların zorunlu olduğunu, hangi tipte olması gerektiğini, sayıların hangi aralıkta kalacağını veya metinlerin hangi kalıba uyacağını tanımlar. Örneğin bir kullanıcı kaydı için şu şema yazılabilir:
{
"type": "object",
"required": ["ad", "eposta"],
"properties": {
"ad": { "type": "string" },
"eposta": { "type": "string", "format": "email" },
"yas": { "type": "integer", "minimum": 18 }
}
}
Bu şemaya göre ad ve eposta alanları olmayan ya da yaşı 18’in altında olan bir kayıt reddedilir. Şema kullanmanın faydaları şunlardır:
- Hatalı veriler sisteme girmeden yakalanır.
- Ekipler arasında verinin yapısı belgelenmiş olur.
- OpenAPI gibi API dokümantasyon standartları şemaları kullanarak otomatik dokümantasyon ve test üretir.
- Kod editörleri şemaya göre otomatik tamamlama ve hata uyarısı gösterebilir.
WordPress ve Web Sitelerinde JSON’u Nerede Görürsünüz?
Bir web sitesi yöneticisi olarak JSON ile farkında olmadan sık sık karşılaşırsınız:
- REST API uç noktaları: WordPress sitelerinde /wp-json/ ile başlayan adresler, sitenin içeriğini JSON olarak sunar. Mobil uygulama ve harici entegrasyonlar bu adresleri kullanır.
- Blok editörü: Temaların renk, yazı tipi ve düzen ayarlarını tanımlayan theme.json dosyası JSON formatındadır.
- Eklenti ayarlarını dışa aktarma: Birçok eklenti ayarlarını JSON dosyası olarak dışa ve içe aktarmanıza izin verir; bu sayede bir sitedeki ayarları başka bir siteye taşıyabilirsiniz.
- Yapılandırılmış veri: SEO eklentilerinin sayfaya eklediği şema işaretlemeleri JSON-LD formatındadır.
- Form ve analiz entegrasyonları: Form gönderimlerini CRM’e aktaran webhook’lar ve izleme araçları veriyi çoğunlukla JSON olarak taşır.
JSON Dosyası Nasıl Oluşturulur ve Açılır?
- Bir metin veya kod editörü açın (Visual Studio Code, Notepad++ gibi).
- Verinizi nesne veya dizi olarak yazın; anahtarları çift tırnak içine alın.
- Dosyayı UTF-8 kodlamasıyla .json uzantılı olarak kaydedin.
- Editörün hata uyarılarını veya bir JSON doğrulayıcıyı kullanarak dosyanın geçerliliğini kontrol edin.
- Görüntülemek için dosyayı tarayıcıda açabilirsiniz; Firefox ve Chrome gibi tarayıcılar JSON’u okunabilir şekilde gösterir veya eklentilerle biçimlendirir.
Metin biçimlendirme için kullanılan sade formatları merak ediyorsanız Markdown nedir yazımız da ilginizi çekebilir.
Web Projelerinizde Teknik Destek
JSON; web sitenizin formlarından ürün feed’lerine, API entegrasyonlarından yapılandırılmış verilere kadar arka planda birçok işi taşır. Gezgin Ajans olarak kurumsal web tasarım projelerimizde entegrasyonları planlıyor, kurumsal SEO danışmanlığı kapsamında JSON-LD yapılandırılmış veri uygulamalarını sitenize uygun şekilde kuruyoruz.
Sıkça Sorulan Sorular
JSON bir programlama dili mi?
Hayır. JSON bir veri formatıdır; veri saklamak ve taşımak için kullanılır. Kendi başına komut çalıştırmaz, değişken veya fonksiyon içermez.
JSON ile JavaScript nesnesi aynı şey mi?
Benzer görünseler de aynı değildir. JSON bir metin formatıdır ve daha katı kurallara sahiptir: anahtarlar çift tırnakla yazılır, fonksiyon ve undefined gibi değerler bulunmaz. JavaScript nesnesi ise bellekte yaşayan bir veri yapısıdır.
JSON’a yorum satırı eklenebilir mi?
Standart JSON yorum satırını desteklemez. Yorum gerekiyorsa yapılandırma aracınızın JSONC veya JSON5 gibi türevleri destekleyip desteklemediğine bakın ya da açıklamayı ayrı bir alan olarak ekleyin.
JSON mı XML mi tercih edilmeli?
Web API’leri, mobil uygulamalar ve yapılandırma dosyaları için genellikle JSON daha pratiktir. Belge odaklı yapılar, güçlü şema doğrulaması gereken kurumsal entegrasyonlar ve site haritası, RSS gibi standartlar için XML kullanılmaya devam eder.
JSON dosyası hangi programla açılır?
JSON düz metin olduğu için her metin editörüyle açılır. Daha okunabilir görüntü için VS Code gibi kod editörlerini veya tarayıcıların JSON görüntüleyicisini kullanabilirsiniz.


