TotalApp Dökümanlar
Ctrl K
Anasayfa
EN | TR
Uygulamaya Git

eBay Entegrasyonu

eBay satıcı hesabınızı OAuth 2.0 ile bağlayın, Fulfillment, Inventory ve Account REST API'leri üzerinden stok ve siparişlerinizi senkronize edin ve stok seviyeleri, sipariş hacmi ve gelir hakkında Yapay Zeka Asistanı'na soru sorun.

Genel Bakış

eBay Entegrasyonu ekranı (E-ticaret → Pazaryeri Yönetimi → eBay), TotalApp ile eBay satıcı hesabınız arasındaki bağlantı merkezidir. OAuth 2.0 bilgilerinizi yönetir, refresh token'ınızı kısa ömürlü kullanıcı erişim token'larına dönüştürür, stok ve siparişlerinizi çeker, kullanılan REST uç noktalarını listeler, günlük çağrı limitlerinizi izler ve pazaryeri verilerinize doğrudan erişimi olan gömülü bir Yapay Zeka Asistanı sunar.

eBay OAuth & Dijital İmza Nasıl Çalışır

eBay'in API ekosistemi şu bileşenlerden oluşur: uygulamanızı doğrulayan App ID (Client ID), Cert ID (Client Secret) ve Dev ID; onay ekranında kullanılan bir RuName (eBay Yönlendirme URL Adı); satıcı başına, taleple taze bir Kullanıcı Erişim Token'ı (~2 saat) üreten Refresh Token (~18 ay geçerli, tenant başına AES-256 şifreli saklanır); ve gerektiren Fulfillment/Finance uç noktalarında x-ebay-signature-key başlığında gönderilen Dijital İmzalar (Ed25519 / RSA-SHA256).

App ID + Cert ID + RuName → Authorization Code Akışı → Refresh Token (tenant başına) → Kullanıcı Erişim Token'ı (2s) + İmza → Fulfillment / Inventory / Account

Yalnızca Sunucu Taraflı API Çağrıları

OAuth token uç noktasına ve REST uç noktasına (api.ebay.com veya api.sandbox.ebay.com) yapılan tüm istekler, tarayıcınızdan değil, TotalApp sunucusundan yapılır. Cert ID, Refresh Token ve imzalama anahtarınız asla tarayıcıya açık edilmez ve CORS kısıtlamaları önlenir.

eBay Geliştirici Kurulum & Onboarding Rehberi

TotalApp'in ihtiyaç duyduğu her şeyi elde etmek için bu dört aşamayı sırayla izleyin. Bu, geliştirici ekibinizin uçtan uca takip edebileceği pratik bir kontrol listesidir.

1eBay Geliştirici Hesabı & Anahtar Setleri

  1. eBay Developers Program'a (developer.ebay.com) katılın ve bir uygulama oluşturun.
  2. Application Keysets altında test için bir Sandbox anahtar seti ve canlı trafik için bir Production anahtar seti alın. Her set bir App ID (Client ID), bir Dev ID ve bir Cert ID (Client Secret) içerir.
  3. Sandbox ve Production anahtarlarını ayrı tutun — bunlar tamamen farklı sunuculara karşı kimlik doğrular.
  4. İpucu: Cert ID yalnızca üretim anında bir kez gösterilir. Güvenli saklayın; kaybederseniz anahtar setini yeniden oluşturmanız gerekir.

2RuName (eBay Yönlendirme URL Adı) Kurulumu

  1. User Tokens → Get a Token from eBay via Your Application bölümünde OAuth Yönlendirme URL'nizi (yetkilendirme kodunu alan uç nokta) yapılandırın.
  2. eBay bir RuName üretir — onay ekranında yönlendirme URL'nizin yerine geçen özel bir takma ad (düz URL kullanılmaz).
  3. Auth Accepted / Declined URL değerlerinizi ve gizlilik politikası bağlantınızı ayarlayın.
  4. RuName değerini kaydedin — TotalApp'e girin.

3OAuth 2.0 Yetkilendirme Akışları

Kullanıcı Erişim Token'ı (Authorization Code Grant) — satıcı kapsamlı işlemler için:

  1. RuName'iniz ve kapsamlarınızla satıcıyı eBay'in onay ekranına yönlendirin.
  2. eBay bir Authorization Code ile geri döner.
  3. Kodu POST /identity/v1/oauth2/token (grant_type=authorization_code) ile bir Access Token (~2s) ve bir Refresh Token (~18 ay) karşılığında değiştirin. Refresh token'ı tenant başına AES-256 şifreli saklayın.
  4. Çağrı sırasında refresh token'ı taze bir access token ile değiştirin (grant_type=refresh_token). TotalApp bunu süre dolmadan ~1 dakika öncesine kadar tenant başına önbelleğe alır.

Uygulama Erişim Token'ı (Client Credentials Grant) — satıcı onayı gerektirmeyen genel/açık veriler (Catalog, Taxonomy) için: POST /identity/v1/oauth2/token uç noktasını grant_type=client_credentials ile çağırın.

4Dijital İmzalar (Payload Signing)

  1. Belirli Fulfillment ve Finance uç noktaları, veri bütünlüğünü sağlamak için istek gövdesi (payload) üzerinde bir Dijital İmza zorunlu kılar.
  2. Bir Ed25519 (veya RSA) anahtar çifti oluşturun ve bir imzalama anahtar id'si almak için açık anahtarı eBay'e kaydedin.
  3. Her imzalı istek için TotalApp, payload'ı özel anahtarınızla imzalar ve imzayı anahtar id'si ile birlikte x-ebay-signature-key başlığında gönderir.
  4. İmzalamayı etkinleştirmek için TotalApp'e Signing Key ID ve Signing Private Key (PEM) girin; bunlar olmadan imzalı uç noktalar imzasız çağrılır (sandbox için güvenli).

Bağlantıyı TotalApp'te Kurma

Ayarlar → Entegrasyonlar → E-Ticaret → eBay bölümünü açın ve şunları girin:

AlanNerede bulunurÖrnek
App ID (Client ID)Developer Program → Application KeysYourApp-XXXX-PRD-...
Cert ID (Client Secret)Developer Program → Application KeysPRD-xxxxxxxxxxxx-...
Dev ID (opsiyonel)Developer Program → Application Keysxxxxxxxx-xxxx-...
RuNameDeveloper Program → User TokensYour_Company-YourApp-PRD-...
Refresh TokenOAuth authorization-code akışındanv^1.1#i^1#...
PazaryeriSatış yaptığınız eBay pazaryeriEBAY_US
OrtamProduction veya Sandboxproduction
Signing Key ID / Private Key (opsiyonel)Dijital imzalar için-----BEGIN PRIVATE KEY-----

eBay Entegrasyonu ekranında Satıcı Bağlantısı panelini açın ve Bağlantıyı Test Et düğmesine tıklayın. TotalApp bir OAuth token değişimi yapar (bilgilerinizi doğrular) ve kapsamı teyit etmek için bir sayfa stok çeker.

eBay Hesabını Bağla düğmesi

eBay Hesabını Bağla düğmesi, yetkilendirme kodu akışını başlatmak için (yapılandırılmış RuName'iniz üzerinden) eBay onay ekranını açar. Canlı ortamda, yönlendirme geri çağrısı yetkilendirme kodunu, tenant'ınız için (şifreli) kaydedilen refresh token ile değiştirir.

API Uç Noktaları & Backend Modülleri

Ekran bir API Uç Noktaları referans paneli sunar. {orderId} ve {sku} gibi yol parametreleri çağrı sırasında doldurulur. Dijital imza gerektiren uç noktalar SIG ile işaretlenir.

Kimlik Doğrulama — api.ebay.com

MetotYolAmaç
POST/identity/v1/oauth2/token (refresh_token)Kullanıcı erişim token değişimi (~2s)
POST/identity/v1/oauth2/token (client_credentials)Uygulama erişim token'ı (açık veri)

REST API'leri — api.ebay.com / api.sandbox.ebay.com

MetotYolModül
GET/sell/fulfillment/v1/ordergetOrders
POST/sell/fulfillment/v1/order/{orderId}/shipping_fulfillment (SIG)createShippingFulfillment
GET/sell/inventory/v1/inventory_itemgetInventoryItems
POST/sell/inventory/v1/bulk_update_price_quantitybulkUpdatePriceQuantity
PUT/sell/inventory/v1/inventory_item/{sku}createOrReplaceInventoryItem
GET/sell/account/v1/fulfillment_policyAccount API (Fulfillment & İade politikaları)

Rate Limit & Yeniden Deneme

eBay uygulama başına günlük çağrı limitleri uygular ve bir limit aşıldığında HTTP 429 döner. TotalApp her istekte X-EBAY-C-MARKETPLACE-ID başlığını gönderir, kullanımı Günlük Çağrı Limitleri göstergesinde izler ve geçici throttling'in bir senkronizasyonu başarısız kılmaması için jitter'lı üstel geri çekilme ile (en fazla 3 deneme) yeniden dener.

Senkronizasyon Ayarları & Kayıtlar

Senkronizasyon Ayarları paneli Otomatik Sipariş Çekme ve Stok & Fiyat Senkronizasyonu anahtarlarını, ayrıca her istekte X-EBAY-C-MARKETPLACE-ID olacak bir Varsayılan Pazaryeri seçicisini (US, GB, DE ve daha fazlası) sunar. Senkronizasyon Kayıtları paneli her bağlantı testini, stok senkronizasyonunu ve sipariş senkronizasyonunu zaman damgası, kapsam ve başarı/başarısızlık detayıyla kaydeder.

Yapay Zeka Asistanı

Yapay Zeka Asistanı paneli, eBay verilerinize sohbet tabanlı bir arayüz sunar. Bilgiler yapılandırıldığında TotalApp, canlı stok ve son 30 günlük siparişlerinizi sunucu tarafında çeker ve bağlam olarak sağlar.

Neler Sorabilirsiniz

  • Stok soruları: “Hangi SKU'lar tükendi veya mevcut stoğu düşük?”
  • Sipariş soruları: “Son 30 günkü siparişlerimi kargo durumuna göre özetle.”
  • Gelir soruları: “Toplam gelirim ne kadar ve en çok satan ürünler hangileri?”

Writer Engine Desteği

Asistan, Ayarlar → Agentic → Writer Engine seçiminize uyar. Local CLI veya Hosted API modunda canlı eBay verisi sunucu tarafında çekilerek bağlama eklenir. Ollama, Local LLM veya Web LLM modunda istek tamamen istemci tarafında çalışır ve canlı pazaryeri verisi kullanılamaz — veriye dayalı raporlar için Local CLI veya Hosted API'ye geçin.

Rapor Olarak Kaydetme

Yapay zeka yanıt verdikten sonra yanıtın altında bir Rapor Olarak Kaydet düğmesi belirir. Tıkladığınızda yanıt, sorunuz ve içinde bulunulan ay ile otomatik olarak adlandırılıp E-ticaret Raporları altına kaydedilir.

Sık Sorulan Sorular

RuName nedir ve neden düz yönlendirme URL'imi kullanamıyorum?
eBay'in OAuth onay ekranları, düz bir URL yerine bir RuName — kayıtlı OAuth yönlendirme URL'nize eşlenen, eBay tarafından üretilen bir takma ad — referans alır. Yönlendirme URL'sini User Tokens altında bir kez yapılandırırsınız; eBay, TotalApp'in onay akışını başlatmak için kullandığı RuName'i üretir.
Token'lar ne kadar süre geçerlidir?
Kullanıcı erişim token'ları yaklaşık 2 saat geçerlidir; TotalApp taleple taze bir tane üretir ve önbelleğe alır. Refresh token ~18 ay geçerlidir ve tenant başına AES-256 şifreli saklanır. Tüm token değişimleri sunucu tarafında yapılır — Cert ID ve refresh token asla tarayıcıya açık edilmez.
Hangi uç noktalar dijital imza gerektirir?
eBay, belirli Fulfillment ve Finance uç noktalarında payload imzalamayı (x-ebay-signature-key başlığı ile) zorunlu kılar — örneğin createShippingFulfillment. Bir imzalama anahtarı yapılandırıldığında TotalApp payload'ı Ed25519/RSA özel anahtarınızla imzalar; referans panelinde SIG ile işaretli uç noktalar bunu gerektirir.
Bilgileri girer girmez test başarısız oluyor. Ne kontrol etmeliyim?
Önce App ID, Cert ID ve Refresh Token'ın doğru olduğunu teyit edin (bir OAuth hatası bunlardan birinin yanlış olduğunu veya token'ın iptal edildiğini gösterir). Ardından Ortam'ın anahtar setinizle eşleştiğini teyit edin — Sandbox anahtar seti sandbox, Production anahtar seti production kullanmalıdır; farklı sunuculara karşı kimlik doğrularlar.

Sonraki Adımlar