SÖZLÜKOtomasyon ve entegrasyon

Payload nedir?

Kısa tanım

Payload, bir API isteğinde ya da yanıtında taşınan asıl veri içeriğidir; adres ve başlık gibi iletim bilgilerinin dışında kalan, çoğunlukla JSON biçimindeki gövdeyi ifade eder.

Son güncelleme:

Payload nedir, bir API isteğinin neresidir?

Bir isteği zarfa benzetirsek, zarfın üstündeki adres ve gönderici bilgisi iletim ayrıntısı, zarfın içindeki mektup ise asıl veridir. Payload bu mektuptur. MDN'in HTTP mesajları sayfası, bir mesajın isteğe bağlı bir gövde içerebileceğini ve bu gövdenin, istekte sunucuya gönderilen veriyi ya da yanıtta istemciye dönen kaynağı taşıdığını anlatır. Ayrıntılar MDN'in HTTP mesajları sayfasında (yeni sekmede açılır) yer alır.

Payload örneği nasıl görünür?

Payload örneği e-ticarette en çok webhook ve API çağrılarında görülür. Bir sipariş bildirimi, JSON biçiminde sipariş numarasını, tutarı ve ürünleri taşır. Genel yapı şöyledir.

  • Sipariş numarası: siparişi tanımlar.
  • Müşteri bilgisi: ad ve iletişim.
  • Ürün listesi: her kalem için ad, adet ve fiyat.
  • Durum: siparişin hangi aşamada olduğu.

Payload boyutu neden önemlidir?

Payload boyutu, isteğin hızını ve kabul edilip edilmeyeceğini etkiler. Sunucular genellikle kabul ettikleri en büyük boyutu sınırlar. Çok sayıda ürünü tek istekte göndermek reddedilmeye ya da zaman aşımına yol açabilir. Büyük veriyi parçalara bölmek, her parçanın sonucunu ayrı kontrol etmek ve gereksiz alanları göndermemek payload'ı hafifletir.

Payload ile çalışırken hangi hatalar yapılır?

En sık hata, beklenen biçimi yanlış göndermektir: sayı yerine metin, eksik zorunlu alan ya da yanlış tarih biçimi. Türkçe karakterlerin yanlış kodlanması da veriyi bozar. Bir diğeri, gelen payload'ın doğruluğunu denetlemeden işlemektir; beklenmeyen alanlar ya da eksik veri sistemi bozabilir. Gelen veriyi önce doğrulayıp sonra işleyin ve hatalı payload'ları kayda alın.

Payload nasıl doğrulanır?

Gelen veriye güvenmeyin; işlemeden önce doğrulayın. Zorunlu alanların bulunduğunu, sayıların sayı, tarihlerin tarih olduğunu ve değerlerin makul aralıkta kaldığını kontrol edin. Beklenmeyen alanları yok sayın ya da reddedin. Birçok API, payload'ın biçimini bir şemayla tanımlar; şemaya karşı doğrulama, hatalı veriyi daha kapıdayken yakalar. Doğrulamada başarısız olan payload'ı kayda alın ki sorunun kaynağını sonra inceleyebilesiniz.

Payload sürümü neden önemlidir?

Karşı sistem payload'ın yapısını değiştirebilir: alan adı, biçim ya da zorunluluk. Bu yüzden sağlayıcının sürüm duyurularını izleyin ve değişiklikte örnek bir istekle sınama yapın.

Payload güvenli mi taşınır?

Payload sipariş ve müşteri bilgisi taşıyorsa bağlantının https ile korunması şarttır. Webhook gibi dışarıdan gelen isteklerde payload'ın gerçekten beklenen kaynaktan geldiğini imza ile doğrulamak da gerekir. Günlüklere kişisel bilgi içeren payload'ı olduğu gibi yazmayın. Veri akışlarını düzenli kurmak için Entegrasyon ve Otomasyon Marketi sayfasına bakabilirsiniz.

Payload nerede karşınıza çıkar?

  • Webhook ile gelen sipariş bilgisinin JSON gövdesi
  • Kargo API'sine gönderilen gönderi kaydı verisi
  • Stok güncellemesi isteğindeki ürün ve adet bilgisi
  • API yanıtında dönen hata mesajı ve ayrıntıları

Sistemlerinizi birbirine bağlayın

Mağaza, ERP ve kargo arasında veriyi düzenli ileten hazır entegrasyonlar.

Payload hakkında sık sorulanlar

Payload ile başlık (header) arasındaki fark nedir?
Başlık isteğin kendisi hakkında bilgi taşır: içerik türü, kimlik doğrulama gibi. Payload ise taşınan asıl veridir, örneğin sipariş bilgisi.
Payload hangi biçimde olur?
En yaygını JSON'dur. XML, form verisi ya da dosya da olabilir. Hangi biçimin beklendiği API dokümanında belirtilir.
Payload çok büyükse ne olur?
Sunucular genellikle kabul edilen boyutu sınırlar. Çok büyük payload reddedilebilir ya da zaman aşımına uğrayabilir. Büyük veriyi parçalara bölmek gerekir.
Ü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.

  • Kredi kartı yok
  • 1 iş gününde dönüş
  • KVKK uyumlu
  • Veriler şifreli bağlantıyla iletilir