ESL seçerken API ve açıklık soruları: sisteminize ne kadar bağlanabilir?

Etiket yönetim yazılımı, kurulduktan sonra yıllarca mağaza operasyonunun bir parçası olur. Bu süre içinde başka sistemlerle konuşması gerekir: ERP, POS, iş zekâsı, stok yönetimi, hatta raf kamerası. Bunun mümkün olup olmadığını belirleyen tek şey, sistemin API'sidir. Bu yazı, satın alma sırasında sorulacak API sorularını ve cevapların ne anlama geldiğini anlatıyor.

Soru 1: API var mı, belgeli mi?

"API var" cevabı yeterli değil; belgesi olmalı ve belgeyi satın alma öncesi görebilmelisiniz. Belgesiz API, tedarikçinin her istekte geliştirme faturası kesmesi demektir. İyi belge; uç noktaları, kimlik doğrulamayı, hata kodlarını ve örnek istekleri içerir.

Soru 2: Hangi işlemler API'den yapılabilir?

Asgari beklenti dört işlemdir: ürün verisi yazma (fiyat güncelleme), eşleştirme sorgulama ve değiştirme, etiket durumu okuma (pil, son iletişim, kapsama), şablon atama. Yalnızca fiyat yazan bir API, entegrasyon için yeterli ama raporlama ve otomasyon için değildir. Veri akışı seçenekleri yazısı dosya ile API'yi karşılaştırıyor.

Soru 3: Kimlik doğrulama ve yetki

API anahtarı mı, OAuth mu? Anahtar başına yetki sınırlanabiliyor mu (salt okunur anahtar verilebiliyor mu)? İş zekâsı aracına salt okunur erişim vermek, tam yetkili anahtar paylaşmaktan çok daha güvenlidir. ESL sistemi güvenli mi yazısı bu katmanı anlatıyor.

Soru 4: Hız sınırı ve toplu işlem

Saniyede kaç istek, tek istekte kaç kayıt? On bin ürünü tek tek göndermek saatler sürer; toplu (batch) uç nokta şarttır. Hız sınırı belgede yazılı olmalı; yazılı değilse üretimde sürpriz olur.

Soru 5: Webhook ve olay bildirimi

Sistem, bir olay olduğunda size haber verebiliyor mu? Örneğin etiket arızalandığında, pil eşiği aşıldığında ya da güncelleme tamamlandığında. Webhook desteği, kendi operasyon akışınızı kurmanızı sağlar; yoksa düzenli sorgulama (polling) yazmak gerekir.

Soru 6: Sürüm politikası

API sürümleniyor mu, eski sürüm ne kadar destekleniyor? Habersiz değişen bir API, entegrasyonunuzu bir sabah durdurur. Sözleşmede "geriye dönük uyumluluk ve en az altı ay geçiş süresi" maddesi, yazılım güncellemeleri yazısındaki bildirim maddesinin API karşılığıdır.

Soru 7: Veri dışa aktarımı

API üzerinden tüm eşleştirme kayıtlarını ve olay günlüğünü indirebiliyor musunuz? Bu, veri sahipliğinin teknik karşılığıdır ve tedarikçi değiştirme ihtimalinizin gerçek ölçüsüdür.

Açık kaynak var mı?

Etiket yönetim yazılımlarının neredeyse tamamı kapalı kaynaktır; protokoller tescillidir ve açık bir standart yoktur. Bu, sektörün tarihsel yapısından gelir; elektronik etiketin kısa tarihi yazısı bunu anlatıyor. Bu yüzden "açık kaynak" beklemek yerine "açık arayüz" istemek gerçekçi taleptir: belgeli API, standart veri biçimleri ve dışa aktarım.

Entegrasyon beyanlarını doğrulamak

Tedarikçi "SAP ile entegre" der; bu, hazır bir bağlayıcı olduğu anlamına da gelebilir, "API'miz var, siz yazarsınız" anlamına da. Entegrasyon iddiası mı entegrasyon mu yazısı ayrımı anlatıyor; entegrasyon matrisi satıcıların kendi beyanlarını kaynağıyla birlikte listeler.

Demoda API testi

Demo sırasında API belgesini isteyin ve bir uç noktayı canlı deneyin: bir ürünün fiyatını API ile değiştirip etikette görün. Beş dakikalık bu test, sayfalarca beyandan daha çok şey söyler. Demo kontrol listesi yazısı testi maddeler arasına alıyor.

Kısa özet

Yedi soru: belgeli API var mı; hangi işlemler; kimlik ve yetki; hız sınırı ve toplu işlem; webhook; sürüm politikası; tam dışa aktarım. Açık kaynak beklemeyin, açık arayüz isteyin ve demoda bir uç noktayı canlı deneyin.

API olmadan yaşanabilir mi?

Evet, ama sınırlı. Dosya tabanlı aktarım çoğu mağazada fiyat güncellemesi için yeterlidir; veri akışı seçenekleri yazısı bunu anlatıyor. API'siz sistemde kaybettikleriniz: kendi raporlarınız, otomatik görev akışları, üçüncü sistemlerle bütünleşme ve tam dışa aktarım. Küçük işletmede bu kayıplar tolere edilebilir; çok mağazalı zincirde edilemez.

Kısa özet

Belgeli API, dört temel işlem, sınırlanabilir yetki, toplu uç nokta, webhook, sürümleme ve tam dışa aktarım. Açık kaynak beklemek gerçekçi değil; açık arayüz istemek gerçekçi ve pazarlık edilebilir bir taleptir.

Kendi raporunuzu çıkarmak

API'nin en somut faydası, tedarikçinin sunmadığı raporu kendiniz çıkarabilmektir: reyon bazında güncelleme süresi, pil ömrü eğrisi, en sık arızalanan etiket grupları. Bu veriler, toplam sahip olma maliyeti hesabınızı gerçek rakamlarla güncellemenizi ve bir sonraki alımda daha iyi pazarlık yapmanızı sağlar.