API (Application Programming Interface), bir yazılımın başka bir yazılıma "şunu ver" ya da "bunu güncelle" diyebildiği kapıdır. İnsan panele girip düğmeye basar; yazılım ise aynı işi API'ye istek göndererek yapar. Pazaryerleri bu kapıyı satıcıların ve entegrasyon yazılımlarının kullanımına açar.
Nasıl çalışır?
API, istek ve yanıt mantığıyla çalışır. Yazılım belirli bir adrese, yani uç noktaya, istek gönderir. Pazaryeri isteği kimin gönderdiğini kontrol eder, işlemi yapar ve sonucu döndürür. Yanıt çoğunlukla JSON biçimindedir.
| Adım | Ne olur | Pazaryeri örneği |
|---|---|---|
| 1. Kimlik | İstekle birlikte API anahtarı gönderilir | Trendyol ve Hepsiburada'da Basic Auth başlığı |
| 2. İstek | Yapılacak işlem ve veri gönderilir | "Şu barkodun stoğu 12 olsun" |
| 3. İşlem | Platform isteği kuyruğa alır ya da hemen işler | Trendyol stok-fiyat güncellemesi toplu işlenir |
| 4. Yanıt | Sonuç ya da hata kodu döner | 200 başarı, 401 kimlik hatası, 429 istek sınırı |
Satıcı için ne işe yarar?
- Stok, fiyat ve ürün bilgisini panele tek tek girmeden güncellemek.
- Yeni siparişleri otomatik çekmek ve kargo bilgisini geri göndermek.
- Müşteri sorularını, iadeleri ve hakediş raporlarını tek yerde toplamak.
Bir ürünü üç pazaryerinde satıyorsanız API sayesinde stok tek yerden yönetilir. Bir kanalda satılan ürün diğerlerinde de düşer.
API mi, XML besleme mi?
XML ürün beslemesi tek yönlüdür: siz bir dosya yayımlarsınız, karşı taraf belirli aralıklarla okur. API ise iki yönlüdür ve anlık işlem yapar. Sipariş çekmek, iade onaylamak ya da soruya cevap vermek için API gerekir. Karşılaştırma için XML entegrasyonu mu, API entegrasyonu mu yazısına bakın.
Güvenlik
API bilgileri mağazanızın anahtarıdır. Bunları e-postayla, ekran görüntüsüyle ya da herkese açık dosyalarla paylaşmayın. Sızdığını düşünürseniz pazaryeri panelinden yenileyin. Ayrıntılar API anahtarı maddesinde.
Her pazaryerinin API'si farklı kurallarla çalışır. Platform bazında kimlik doğrulama, uç noktalar ve hata kodları için pazaryeri API rehberi bölümüne bakabilirsiniz.