eBay'in Claude ile iletişim kurmasını sağlamak kavramsal olarak zor değil. Bir OAuth uygulaması, dört değer ve bir izin listesi gerekiyor. Zorluk, eBay'in bu değerlere diğer tüm pazar yerlerinden farklı adlar vermesi ve bir alanın, tam olarak URL'ye benzeyen ama URL olmayan bir şey istemesi.
Dört değer ve eBay'in bunlara verdiği adlar
App ID istemci kimliğidir. Cert ID istemci sırrıdır. İkisi de eBay Geliştirici Portalı'nda Hesabım → Uygulama Anahtarları altında bulunur ve ikisi de doğrudan kopyalanıp yapıştırılır.
RuName insanların takıldığı değerdir; aşağıda ona özel bir bölüm var.
Pazar Yeri Kimliği hangi eBay sitesinde işlem yaptığınızı seçer ve o pazar yerinin desteklediği bir yerel ayarla eşleşmelidir. Bu genellikle açıktır — ta ki olmayana kadar. eBay, Malezya ve Singapur için en-US belirtir; bu da tam olarak bir rehberden değil, bir hata mesajından öğrendiğiniz türden bir ayrıntıdır.
RuName bir addır, adres değil
Geliştirici portalında Anahtar Kümesi → Kullanıcı Tokenları → Uygulamanız Üzerinden Token Al yolunu izler ve bir Yönlendirme URL'si kaydı oluşturur veya açarsınız. Bu kayıtta “Yetkilendirmenin kabul edildiği URL'niz” alanını bağladığınız istemcinin geri çağırma adresine ayarlarsınız. Orkas'ın kullandığı adres: https://orkas.ai/api/connectors/oauth/dcr-callback; bunun için kendinize ait bir sunucu gerekmez.
Ardından — kritik adım budur — kopyalamanız gereken değer, RuName eBay'in o kayıt için oluşturduğu değerdir. Az önce yazdığınız URL'nin yanında duran, anlamı belli olmayan kısa bir dizedir. Bu değeri isteyen alanın çevresi URL alanlarıyla doludur; bu yüzden insanın içinden URL'yi yeniden yapıştırmak gelir. Bu şekilde yetkilendirme gerçekleşmez ve dönen hata nedenini söylemez.
Test ortamı kestirme yol değildir
eBay, iyi durumda bir satıcı hesabı gerektirmeyen, yalnızca ücretsiz bir geliştirici hesabıyla kullanılabilen bir test ortamı sunar; bu, API'nin yapısını öğrenmek için gerçekten yararlıdır. Ancak asıl istediğiniz şey, yani kendi ilanlarınız ve siparişleriniz için yararlı değildir. Test ortamındaki veriler yapaydır.
Orkas'taki yeni bağlantılar yalnızca üretim ortamını kullanır. Bu da kurulumun en uzun süren kısmının sonradan seçtiğiniz istemci değil, eBay Developers Program başvurusu — satıcı hesabı, envanter, ilan ve sipariş karşılama izinlerine sahip bir uygulama ile onun Üretim Anahtar Kümesi — olduğu anlamına gelir. Buna erken başlayın. Resmî yetkilendirme rehberini başvurunuz sonuçlanmayı beklerken okumaya değer.
Okumak, yazmak değildir
Anahtar kümesi oluşturulduktan sonra, bağlantının gerçekte ne işe yarayacağını izin listesi belirler. Geçen hafta ne satıldığını sormak bir okuma işlemidir. Bir ilanı değiştirmek, envanteri ayarlamak veya bir siparişi gönderildi olarak işaretlemek ise yazma işlemidir ve uygulamada ilgili yetki kapsamlarını gerektirir.
Sunucuda barındırılan çeşitli eBay-Claude hizmetleri tasarım gereği salt okunurdur; bu makul bir üründür ama aynı ürün değildir. Başvuruya emek vermeden önce yazma tarafını kontrol edin; çünkü her iki durumda da öncesindeki başvuru aynıdır.
Orkas bağlayıcısı, kendi makinenizden üretim ortamındaki Sell API'leriyle çalışır. Kimlik bilgileri bir yapılandırma dosyasında veya başkasının sunucularında tutulmak yerine cihazda şifrelenir; canlı bir hesaba yazan her işlem, modelin dikkatli olmasına güvenmek yerine istemcide bir izin isteminden geçer.
Başka bir çözümün daha uygun olduğu durumlar
Yalnızca rapor istiyorsanız: sunucuda barındırılan bir bağlayıcı daha az kurulum gerektirir ve yüklenecek bir şey yoktur. Kimse başında durmadan bir programa göre çalışmasını istiyorsanız: bu bir masaüstü uygulamasıdır; pencereyi kapatınca durur. Uygun çözüm, sunucuda zamanlanmış bir görevdir. API'yi hâlâ öğreniyorsanız: test ortamını ve ücretsiz bir geliştirici hesabını kullanın; henüz hiçbir şeyi canlı bir hesaba bağlamayın.
Aynı katalog Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce ve Çin platformlarını kapsar; böylece kimlik bilgileriyle uğraşma işi her mağazada baştan başlamaz. İlgili yazılar: Etsy ve Shopify bu ikisi için aynı konuları ele alır.