API ve Entegrasyon

Pazaryeri API Entegrasyonu

Bir pazaryeri hiçbir zaman tek başına çalışmaz. Stok ERP'de, muhasebe kaydı e-fatura servisinde, kargo hareketi taşıyıcıda durur. API katmanının işi bu sistemleri tek bir işleyen bütün haline getirmek; aksi halde her gün elle veri taşıyan bir ekip gerekir.

Ücretsiz DeneyinFiyat Teklifi Alın
Ürün, sipariş, stok, satıcı ve içerik uçları
REST APIÜrün, sipariş, stok, satıcı ve içerik uçları
Olay tabanlı bildirim; sürekli sorgulama gerekmez
WebhookOlay tabanlı bildirim; sürekli sorgulama gerekmez
Kod yazmadan kural tabanlı otomasyon
İş akışlarıKod yazmadan kural tabanlı otomasyon
XML, CSV ve Excel ile zamanlanmış içe aktarım
Toplu aktarımXML, CSV ve Excel ile zamanlanmış içe aktarım

Entegrasyonu Ne Zaman API, Ne Zaman Webhook Çözer?

Bir pazaryeri hiçbir zaman tek başına çalışmaz. Satıcının stoğu kendi ERP'sinde, muhasebe kaydı e-fatura servisinde, kargo hareketi taşıyıcının sisteminde, pazarlama verisi reklam platformunda durur. Pazaryeri API entegrasyonunun işi bu ayrı sistemleri tek bir işleyen bütün haline getirmektir; aksi halde her gün elle veri taşıyan bir ekip kurmanız gerekir.

Entegrasyonun yönü iki türlüdür ve ikisi farklı araç ister. Dışarıdan içeri veri almak (satıcının ürün ve stok bilgisi, tedarikçi fiyat listesi) genellikle zamanlanmış toplu aktarımla ya da API çağrılarıyla yapılır. İçeriden dışarı bilgi göndermek (yeni sipariş oluştu, kargo yola çıktı, iade açıldı) ise webhook ile yapılmalıdır. Sürekli sorgulama ile çalışan entegrasyonlar hem gecikir hem gereksiz yük üretir.

Üçüncü konu dayanıklılıktır. Gerçek entegrasyonlarda karşı sistem yanıt vermez, aynı olay iki kez iletilir veya istek zaman aşımına uğrar. Bu yüzden idempotency anahtarları, otomatik yeniden deneme, oran sınırı ve hata kuyruğu isteğe bağlı süsler değil temel gereksinimlerdir. PazaryeriSoft'ta bunlar API katmanının parçası olarak gelir.

Modüller

API Katmanında Hazır Gelen Modüller

REST API ve Dokümantasyon

Kaynak bazlı uçlar, tutarlı hata biçimi ve sayfalama. Entegrasyon ekibi örnek istek ve yanıtlarla çalışır.

Webhook Yönetimi

Hangi olayın hangi adrese gideceği panelden tanımlanır; iletim geçmişi ve başarısız denemeler görüntülenebilir.

API Anahtarı ve Kapsam Yönetimi

Her entegrasyon için ayrı anahtar; anahtar bazında okuma-yazma kapsamı ve IP kısıtı tanımlanır.

Idempotency ve Yeniden Deneme

Aynı isteğin iki kez gelmesi mükerrer kayıt oluşturmaz; başarısız çağrılar artan aralıklarla yeniden denenir.

Oran Sınırı ve Kota

Entegrasyon başına istek sınırı tanımlanır; sınıra yaklaşıldığında yanıt başlıklarında uyarı döner.

XML, CSV ve Excel İçe Aktarım

Zamanlanmış içe aktarım ile satıcı ve tedarikçi katalogları düzenli senkronlanır; alan eşleştirme bir kez yapılır.

İş Akışı Otomasyonu

Kod yazmadan kural tanımlama: belirli koşulda bildirim gönder, etiket ekle, satıcıyı kısıtla veya dış servise istek at.

Toplu Dışa Aktarım

Sipariş, ürün ve hakediş verisinin raporlama ve veri ambarı için dışa aktarımı.

İstek Kayıtları ve Hata Kuyruğu

Gelen ve giden çağrılar kaydedilir; hatalı işlemler kuyrukta toplanır ve elle yeniden çalıştırılabilir.

İmzalı İstek Doğrulama

Webhook gövdeleri imzalanır; alıcı taraf isteğin gerçekten sizden geldiğini doğrulayabilir.

Sağlayıcı Bağımsız Arayüzler

Ödeme, kargo ve fatura sağlayıcıları ortak arayüz üzerinden bağlanır; sağlayıcı değişimi uygulama kodunu etkilemez.

Uygulama Ekosistemi

Ek modüller ve üçüncü taraf uygulamalar aynı API katmanı üzerinden platforma bağlanır.

Kapsam

API Yüzeyi ve Olay Bildirimleri

Solda dışarıdan çağırabileceğiniz uçlar, sağda sistemin size ilettiği olaylar. Çoğu entegrasyon ikisini birlikte kullanır.

API yüzeyi

  • Ürün, varyant, kategori ve özellik uçları
  • Stok ve fiyat güncelleme; toplu güncelleme desteği
  • Sipariş listeleme, durum güncelleme ve iade işlemleri
  • Satıcı, mağaza ve organizasyon yönetimi
  • Müşteri, adres ve favori kayıtları
  • İçerik, kampanya ve kupon yönetimi
  • Token tabanlı kimlik doğrulama ve kapsam bazlı yetkilendirme

Olay bildirimleri (webhook)

  • Sipariş oluştu, ödendi, iptal edildi, iade açıldı
  • Kargo etiketi üretildi, gönderi yola çıktı, teslim edildi
  • Ürün yayınlandı, reddedildi, stok tükendi
  • Satıcı başvurusu onaylandı veya askıya alındı
  • Hakediş oluştu, çekim talebi onaylandı
  • İmzalı istek gövdesi ile kaynak doğrulaması
  • Başarısız iletimde artan aralıklarla otomatik yeniden deneme
Senaryolar

En Sık Kurulan Altı Entegrasyon

Hepsi aynı API katmanı üzerinden yürür; farklı olan yalnızca veri yönü ve tetikleyici.

ERP ve Stok Senkronizasyonu

Satıcının kendi sisteminde değişen stok ve fiyat bilgisi zamanlanmış aktarım veya API çağrısıyla platforma yansır; sipariş oluştuğunda webhook ile ERP'ye düşer.

e-Fatura ve Muhasebe

Komisyon faturaları ve hakediş kayıtları Paraşüt, BirFatura gibi servislere aktarılır. Mutabakat kayıtları muhasebe tarafında otomatik oluşur.

Kargo ve Lojistik Sistemleri

Etiket üretimi ve durum güncellemeleri taşıyıcı entegrasyonları üzerinden yürür; gönderi hareketleri siparişe otomatik işlenir.

Pazarlama ve Analitik

Sipariş ve ürün verisi reklam platformlarına ve analitik araçlarına aktarılır; ürün akışları (feed) düzenli olarak yenilenir.

Dış Pazaryerlerine Listeleme

Platformunuzdaki katalog dış kanallara aktarılabilir; sipariş ve stok senkronu iki yönlü çalışacak şekilde kurgulanır.

Özel Ön Yüz ve Headless Kullanım

Kendi arayüzünüzü yazıp platformu yalnızca veri katmanı olarak kullanabilirsiniz; mobil uygulama da aynı API'yi tüketir.

SSS

Sıkça Sorulan Sorular

Entegrasyon ekiplerinin en sık sorduğu sorular.

İkisi farklı yönler içindir. Dışarıdan içeri veri almak (satıcının ürün ve stok bilgisi, tedarikçi fiyat listesi) için API çağrıları veya zamanlanmış toplu aktarım kullanılır. İçeriden dışarı bilgi göndermek (yeni sipariş oluştu, kargo yola çıktı, iade açıldı) için ise webhook doğru araçtır. Bunu sürekli sorgulamayla çözmek hem gecikme yaratır hem gereksiz yük üretir; olay tabanlı bildirim her iki sorunu da ortadan kaldırır.
Hayır. Yazma işlemlerinde idempotency anahtarı kullanılır; aynı anahtarla gelen ikinci istek yeni kayıt oluşturmaz, ilk işlemin sonucunu döner. Webhook tarafında da aynı olay yeniden iletilebileceği için alıcı sistemin olay kimliğini kontrol etmesi önerilir. Bu, gerçek entegrasyonlarda kaçınılmaz olan tekrar iletimlerini zararsız hale getirir.
Başarısız webhook iletimleri artan aralıklarla otomatik olarak yeniden denenir. Denemeler tükendiğinde kayıt hata kuyruğunda toplanır ve panelden elle yeniden çalıştırılabilir. Gelen ve giden çağrılar kaydedildiği için hangi isteğin ne zaman ve hangi yanıtla sonuçlandığı sonradan incelenebilir; entegrasyon sorunlarının çoğu bu kayıtlarla dakikalar içinde çözülür.
Her entegrasyon için ayrı anahtar üretilir. Anahtar bazında okuma-yazma kapsamı tanımlanır; örneğin bir raporlama entegrasyonuna yalnızca okuma yetkisi verilir. İsteğe bağlı olarak IP kısıtı eklenebilir ve anahtar herhangi bir anda iptal edilebilir. Böylece bir entegrasyonun ele geçirilmesi tüm sistemi değil yalnızca o kapsamı etkiler.
Evet, entegrasyon başına istek sınırı tanımlanır. Sınıra yaklaşıldığında yanıt başlıklarında kalan kota bilgisi döndürülür, böylece istemci tarafı kendini yavaşlatabilir. Toplu işlemler için tek tek çağrı yapmak yerine toplu güncelleme uçlarını veya zamanlanmış içe aktarımı kullanmanızı öneririz; hem daha hızlıdır hem kotayı yormaz.
Evet, iş akışı editörü bunun için var. Koşul ve eylemlerden oluşan kurallar tanımlarsınız: belirli bir durumda bildirim gönder, sipariş etiketle, satıcıyı kısıtla veya dış bir servise istek at. Basit entegrasyonların önemli bir kısmı geliştirici gerektirmeden bu şekilde çözülür; API'ye yalnızca daha karmaşık senaryolarda ihtiyaç duyulur.
Evet. Satıcılar kendi ERP veya stok sistemlerini API üzerinden bağlayabilir ya da XML, CSV, Excel formatında zamanlanmış içe aktarım kurabilir. Alan eşleştirmesi ilk kurulumda bir kez yapılır, sonraki aktarımlar aynı şablonu kullanır. Yapay zeka destekli alan eşleme, farklı formatlardaki katalogların bağlanma süresini kısaltır.

İlgili Sayfalar

Pazaryeri Mobil Uygulama

Aynı API katmanını tüketen iOS ve Android uygulaması.

Headless E-Ticaret

Platformu yalnızca veri katmanı olarak kullanıp kendi ön yüzünüzü yazma modeli.

Pazaryeri Ödeme Sistemi

Sağlayıcı bağımsız arayüzle bağlanan ödeme kuruluşu entegrasyonları.

Tüm Pazaryeri Özellikleri

API, iş akışı ve veri aktarım modüllerinin tam boy anlatımı.

Entegrasyonlarınızı Birlikte Planlayalım

Hangi sistemlerin bağlanacağını, veri yönlerini ve tetikleyicileri çıkaralım.

Ücretsiz DeneyinFiyat Teklifi Alın

REST API + Webhook · İş akışı otomasyonu · 7/24 destek