eBay API Entegrasyonu: Türk Satıcılar İçin Adım Adım Teknik Rehber
Özet
eBay API entegrasyonu üç katmandan oluşur: kimlik doğrulama (OAuth 2.0), katalog yönetimi (Inventory API) ve sipariş akışı (Fulfillment API). Türk satıcılar için en kritik adım eBay global hesabı açıp hesabı doğrulatmaktır; bu süreç 3–7 iş günü sürer. Teknik entegrasyon sonrasında 500+ SKU'lu mağazalarda sipariş işleme süresi %70 oranında kısalmaktadır.
eBay API Neden Kullanılır?
Manuel eBay yönetimi; ürün sayısı arttıkça sürdürülemez hale gelir. eBay API, satıcıların kendi yazılımları veya ERP sistemleriyle eBay'i entegre etmesini sağlar.
- Ürün listeleme ve güncellemeyi toplu olarak otomatize etmek
- Stok seviyelerini kendi sisteminizle senkronize tutmak
- Sipariş bildirimleri almak ve kargo takibi güncellemek
- Fiyat optimizasyonu için rakip verisi çekmek
- eBay mağazası performans raporlarına programatik erişim
eBay API Türleri: Hangisi Ne İşe Yarar?
eBay, RESTful yapıda modüler API'ler sunar. Her modül belirli bir iş sürecini kapsar.
- Inventory API — ürün ve stok yönetimi (çok lokasyon desteği dahil)
- Fulfillment API — sipariş alma, güncelleme ve kargo takibi
- Account API — ödeme ve hesap yapılandırması
- Buy API — alıcı tarafı arama ve ürün sorguları
- Sell Feed API — toplu ürün yükleme için CSV/JSON feed işleme
- Analytics API — satış ve görünürlük raporları
OAuth 2.0 ile Kimlik Doğrulama
eBay API tüm isteklerde OAuth 2.0 token gerektirir. İki token tipi vardır: Application Token (kullanıcı oturumu gerektirmeyen işlemler) ve User Token (satıcı adına işlem yapılan tüm write endpoint'leri).
- 1. eBay Developer Program'a kayıt olun (developer.ebay.com)
- 2. Production Application oluşturun, Client ID ve Client Secret alın
- 3. Sandbox ortamında test hesabı açın
- 4. Authorization Code Flow ile satıcı izni alın
- 5. Access Token (2 saat) ve Refresh Token (18 ay) saklayın
- 6. Token yenileme (refresh) mekanizmasını sunucu tarafında otomatize edin
Sandbox Ortamında Test Süreci
eBay, canlı hesabı etkilemeden API'yi test edebileceğiniz tam işlevsel bir sandbox ortamı sunar. Sandbox'ta sahte alıcı ve satıcı hesapları oluşturulabilir.
- Sandbox URL: api.sandbox.ebay.com (production: api.ebay.com)
- Sandbox token'ı production token'ından bağımsız üretilir
- Gerçek para hareketi yoktur — test ödemeleri simüle edilir
- Tüm Inventory ve Fulfillment endpoint'leri sandbox'ta mevcuttur
- Tavsiye: sandbox'ta en az 50 ürün, 10 sipariş senaryosu test edilmeli
Türk Satıcıların Sık Karşılaştığı Teknik Engeller
eBay entegrasyonunda Türk satıcıların özellikle yaşadığı sorunlar teknik ve hesap doğrulama kaynaklıdır.
- Hesap kısıtlaması: yeni eBay hesapları ilk 90 günde liste limiti ile başlar
- Ödeme entegrasyonu: eBay Managed Payments zorunlu, Türk banka hesabıyla 7–14 gün onay süreci
- Kargo entegrasyonu: uluslararası kargo fiyat hesabı için ShipEngine veya EasyPost API önerilir
- Döviz yönetimi: USD/GBP/EUR fiyatlandırma için otomatik kur güncelleme scripti gerekir
- Rate limiting: saatte 5.000 API çağrısı limiti — toplu işlemlerde queue yapısı şart
Entegrasyon Süreci ve Zaman Çizelgesi
Solman Digital tarafından gerçekleştirilen eBay API projelerinde standart süreç şu şekilde işlemektedir:
- Hafta 1: OAuth kurulumu + sandbox entegrasyonu + Inventory API testi
- Hafta 2: Fulfillment API + sipariş webhook'ları + kargo takibi
- Hafta 3: Production geçiş + stres testi + hata yönetimi
- Hafta 4: İzleme panosu + alert sistemi + dokümantasyon
- Toplam: 500 SKU'ya kadar projeler genellikle 3–4 haftada canlıya geçer
Sık Sorulan Sorular
eBay API kullanmak için ücret ödeniyor mu?
eBay API'nin kendisi ücretsizdir. Ancak eBay üzerinden yapılan satışlarda standart satıcı komisyonları (%8–15, kategoriye göre değişir) geçerlidir. API çağrı limitleri aşıldığında ek ücret değil kısıtlama uygulanır.
Türkiye'den eBay'de satış yapabilir miyim?
Evet, Türkiye'den eBay global satıcı hesabı açılabilir. eBay Managed Payments sistemi Türkiye'yi desteklemektedir; ancak hesap doğrulama ve ödeme hesabı onayı 7–14 iş günü sürebilir.
WooCommerce veya Shopify ile eBay entegrasyonu mümkün mü?
Evet. WooCommerce için CedCommerce eBay Integration eklentisi, Shopify için eBay Channel app hazır çözümler sunar. Özel ERP entegrasyonu veya yüksek SKU hacmi için doğrudan API tercih edilir.
eBay API entegrasyonu ne kadar sürer?
Temel stok + sipariş entegrasyonu 3–4 haftada tamamlanır. Çok kanallı (Trendyol + Hepsiburada + eBay) senkronizasyon içeren projelerde süre 6–8 haftaya uzayabilir.
Solman Digital
Bu rehber, gerçekleştirilen projelerden derlenen doğrudan deneyime dayanmaktadır. Konuya ilişkin sorularınız için doğrudan uzman erişimi sunuyoruz.
eBay API entegrasyonu ve çok kanallı satış otomasyonu için
Ücretsiz Araçlar
Rakamları Kendiniz Hesaplayın
Entegrasyon veya geliştirme kararı vermeden önce TicaretHub'un ücretsiz hesaplama araçlarıyla mevcut durumunuzu analiz edebilirsiniz.