جعل eBay يتواصل مع Claude ليس صعبًا من حيث المبدأ. إنه تطبيق OAuth وأربع قيم وقائمة أذونات. الصعوبة أن eBay يسمّي تلك القيم بطريقة مختلفة عن كل الأسواق الأخرى، وأن أحد الحقول يطلب شيئًا يبدو تمامًا كرابط URL لكنه ليس كذلك.
القيم الأربع، وما يسميها به eBay
App ID هو معرّف العميل. Cert ID هو سرّ العميل. كلاهما موجود في بوابة مطوّري eBay ضمن حسابي → مفاتيح التطبيقات، وكلاهما مجرد نسخ ولصق.
RuName هو ما يسبب التعثر للناس، وله قسم خاص أدناه.
معرّف السوق يحدد موقع eBay الذي تعمل عليه، ويجب أن يطابق إعدادًا محليًا يدعمه ذلك السوق. هذا واضح في الغالب — إلى أن لا يكون كذلك. يحدد eBay en-US لماليزيا وسنغافورة، وهو بالضبط نوع التفاصيل الذي تكتشفه من رسالة خطأ بدلًا من دليل.
RuName اسم، لا عنوان
في بوابة المطوّرين، انتقل إلى مجموعة المفاتيح → رموز المستخدم → الحصول على رمز عبر تطبيقك، وأنشئ إدخالًا لرابط إعادة توجيه أو افتح إدخالًا موجودًا. في ذلك الإدخال، اضبط «رابط قبول التفويض الخاص بك» على عنوان ردّ النداء للعميل الذي تربطه. يستخدم Orkas https://orkas.ai/api/connectors/oauth/dcr-callback، ولا يتطلب ذلك خادمًا خاصًا بك.
ثم — وهذه هي الخطوة المهمة — تنسخ RuName الذي أنشأه eBay لذلك الإدخال. وهو سلسلة قصيرة مبهمة بجوار عنوان URL الذي كتبته للتو. والحقل الذي يطلبها محاط بحقول عناوين URL، لذا يدفعك الحدس إلى لصق عنوان URL مرة أخرى. لكن ذلك لا يمنح التفويض، ورسالة الخطأ التي تظهر لا تبيّن السبب.
البيئة التجريبية ليست طريقًا مختصرًا
يوفّر eBay بيئة تجريبية لا تحتاج إلا إلى حساب مطوّر مجاني، دون الحاجة إلى حساب بائع مستوفٍ للمتطلبات، وهي مفيدة فعلًا لتعلّم بنية واجهة API. لكنها لا تفيدك في ما تريده فعليًا، أي قوائم منتجاتك وطلباتك أنت. فبيانات البيئة التجريبية اصطناعية.
تستخدم الاتصالات الجديدة في Orkas بيئة الإنتاج فقط. وهذا يعني أن طلب الانضمام إلى eBay Developers Program — بتطبيق يملك أذونات حساب البائع والمخزون وقوائم المنتجات وتنفيذ الطلبات، ومجموعة مفاتيح الإنتاج الخاصة به — هو أكثر مراحل الإعداد استغراقًا للوقت، وليس العميل الذي تختاره لاحقًا. ابدأ به مبكرًا. إن دليل التفويض الرسمي جدير بالقراءة أثناء انتظار الموافقة على الطلب.
القراءة ليست الكتابة
بعد إنشاء مجموعة المفاتيح، تحدد قائمة الأذونات الغرض الفعلي من الاتصال. فالسؤال عمّا بيع الأسبوع الماضي عملية قراءة. أما تعديل قائمة منتج، أو ضبط المخزون، أو وضع علامة على طلب بأنه شُحن، فهي عمليات كتابة تحتاج إلى نطاقات الأذونات المقابلة في التطبيق.
صُممت عدة خدمات مستضافة لربط eBay بـ Claude لتكون للقراءة فقط، وهذا منتج معقول — لكنه ببساطة منتج مختلف. تحقق من إمكانات الكتابة قبل استثمار جهدك في تقديم الطلب، لأن الطلب المطلوب في الحالتين واحد.
يعمل موصّل Orkas مع واجهات Sell API الخاصة ببيئة الإنتاج من جهازك نفسه. تُشفَّر بيانات الاعتماد على الجهاز بدلًا من حفظها في ملف إعدادات أو على خوادم جهة أخرى، وأي عملية تكتب إلى حساب فعلي تمر عبر طلب إذن في العميل، بدلًا من الاعتماد على حذر النموذج.
متى يكون خيار آخر أنسب
إذا كنت تريد التقارير فقط: فالموصّل المستضاف يحتاج إلى إعداد أقل، ولا يتطلب تثبيت أي شيء. تريد تشغيله وفق جدول زمني دون مراقبة أحد: هذا تطبيق مكتبي، لذا يتوقف عند إغلاق النافذة؛ والمهمة المجدولة على خادم هي الخيار المناسب. إذا كنت لا تزال تتعلم واجهة API: فاستخدم البيئة التجريبية وحساب مطوّر مجانيًا، ولا تربط أي شيء بحساب فعلي بعد.
الدليل نفسه يغطي Etsy وWalmart Marketplace وAmazon Seller Central وShopify وWooCommerce والمنصات الصينية، فلا تضطر إلى تكرار التعامل مع بيانات الاعتماد لكل متجر على حدة. وتتناول المقالتان المجاورتان عن Etsy و Shopify الموضوع نفسه لهاتين المنصتين.