SÖZLÜKOtomasyon ve entegrasyon

JSON nedir?

Kısa tanım

JSON (JavaScript Object Notation); yazılımların birbirine veri gönderirken kullandığı, insanın da okuyabildiği, hafif ve dilden bağımsız metin tabanlı bir veri biçimidir. Sipariş, ürün ya da müşteri gibi bir kayıt, alan adı ve değer çiftleri hâlinde yazılır.

Son güncelleme:

JSON nedir, neye benzer?

Mağaza sahibi için JSON nedir sorusunun yanıtı şudur: iki yazılımın birbirine veri gönderirken kullandığı ortak yazım biçimidir. Bir sipariş, ürün ya da müşteri kaydı; alan adı ve değer çiftleri hâlinde, süslü parantezlerin içinde yazılır. Biçimi tanımlayan RFC 8259 (yeni sekmede açılır) belgesi JSON'u "hafif, metin tabanlı, dilden bağımsız bir veri değişim biçimi" olarak tanımlar. Metin olduğu için insan da okuyabilir, program da işleyebilir.

Temsilî bir sipariş kaydı JSON ile şöyle görünür:

{
  "siparis_no": 1001,
  "musteri": "Ayşe",
  "toplam": 1250.00,
  "odendi": true,
  "urunler": [
    { "sku": "TSH-ERK-SYH-L", "adet": 2 }
  ]
}

JSON hangi veri türlerini taşır?

JSON altı tür değer taşır: nesne, dizi, metin, sayı, doğru/yanlış ve boş. Bir sipariş kaydının tamamı bir nesnedir; içindeki ürün listesi bir dizidir. RFC 8259'a göre sistemler arasında taşınan JSON metni UTF-8 ile kodlanır; bu sayede "Ayşe" ya da "gömlek" gibi Türkçe karakterler bozulmadan gider.

JSON veri türleri ve e-ticaretteki karşılıkları
Tür Nasıl yazılır Örnek
Nesne { } içinde ad ve değer çiftleri Bir sipariş, bir müşteri
Dizi [ ] içinde sıralı değerler Siparişteki ürünler
Metin Çift tırnak içinde "Yurtiçi Kargo"
Sayı Tırnaksız 1250.00
Doğru / yanlış true ya da false Ödendi mi?
Boş null Henüz girilmemiş takip kodu

Mağaza sahibi JSON'u nerede görür?

JSON, mağazanızın dış sistemlerle konuştuğu her yerdedir. WooCommerce ve WordPress'in REST API'si sipariş ve ürün bilgisini JSON olarak verir; pazaryeri, kargo ve e-fatura API'leri de isteği ve yanıtı bu biçimde bekler. Bir webhook "yeni sipariş" haberini JSON gövdesiyle taşır. Entegrasyon panellerindeki günlük (log) kayıtları ve dışa aktarma dosyaları da çoğunlukla JSON'dur. Siz yazmazsınız; ama bir hata kaydında gördüğünüzde hangi alanın eksik ya da yanlış olduğunu okuyabilirsiniz.

"Geçersiz JSON" hatası ne demek?

Geçersiz JSON hatası, gelen metnin biçim kurallarına uymadığını söyler. En sık nedenler: unutulan ya da fazladan konan virgül, tek tırnakla yazılmış metin, kapanmayan parantez ve yanlış karakter kodlaması. Bir sağlayıcının bir alanı sayıdan metne çevirmesi ise biçimi bozmaz ama anlamı bozar; istek başarılı görünür, akış yanlış çalışır. Bu ikinci durumu nasıl yakalayacağınızı API entegrasyon hatası nasıl önlenir yazısında anlattık. Entegrasyonlarınızın hangi alanlara dayandığını görmek için ücretsiz sistem analizinden yazabilirsiniz.

Nerede karşınıza çıkar?

  • WooCommerce ve WordPress REST API'sinin sipariş ve ürün yanıtları
  • Pazaryeri, kargo ve e-fatura API'lerine gönderilen istekler
  • Webhook ile gelen "yeni sipariş" ya da "kargoya verildi" bildirimi
  • Entegrasyon panellerindeki günlük (log) kayıtları ve dışa aktarma dosyaları
  • Ürün sayfasındaki yapılandırılmış veri (schema.org) etiketi

Veri biçimi değişince ne olur?

Sağlayıcı JSON yanıtındaki bir alanı değiştirince entegrasyonun neden sessizce bozulduğunu ve nasıl önleneceğini anlattık.

API entegrasyon hatası yazısını okuyun

JSON hakkında sık sorulanlar

JSON ile XML arasındaki fark nedir?
İkisi de sistemler arasında veri taşıyan metin biçimidir. XML her alanı açılış ve kapanış etiketiyle yazar; JSON aynı bilgiyi daha az karakterle, ad ve değer çiftleriyle yazar. Yeni web API'lerinin çoğu JSON kullanır; e-fatura gibi bazı resmî sistemler XML ister. Entegrasyon aracı ikisini birbirine çevirebilir.
JSON dosyasını nasıl açarım?
JSON düz metindir; Not Defteri, TextEdit ya da herhangi bir kod düzenleyiciyle açılır. Tarayıcıya sürüklediğinizde çoğu tarayıcı girintili ve katlanabilir biçimde gösterir. Dosyayı düzenleyip kaydederken tırnak ve virgülleri bozmamaya dikkat edin; tek karakter hatası dosyayı geçersiz yapar.
Mağaza sahibi olarak JSON öğrenmem gerekir mi?
Yazmanız gerekmez; kurulumu entegrasyon ekibi yapar. Okuyabilmek ise işinize yarar: bir hata kaydında hangi alanın boş geldiğini ya da sağlayıcının hangi alanı değiştirdiğini görebilirsiniz. Yukarıdaki tablo bunun için yeterlidir.
ÜCRETSİZ, 1 İŞ GÜNÜ

İlk adımı birlikte atalım

Operasyonunuzdaki elle yürüyen işleri inceleyip ayda kaç saatin sistemle yürüyebileceğini yazılı olarak veriyoruz; teknik bilgi ve taahhüt gerekmez.

Ücretsiz Sistem Analizi Al Kullanım Senaryoları
  • Kredi kartı yok
  • 1 iş gününde dönüş
  • KVKK uyumlu
  • Veriler şifreli bağlantıyla iletilir