การทำให้ eBay คุยกับ Claude ไม่ได้ยากในเชิงแนวคิด แค่มีแอป OAuth ค่าสี่ค่า และรายการสิทธิ์ ความยากคือ eBay ตั้งชื่อค่าเหล่านี้ต่างจากมาร์เก็ตเพลซอื่นทุกแห่ง และมีฟิลด์หนึ่งขอสิ่งที่หน้าตาเหมือน URL ทุกประการแต่ไม่ใช่ URL
ค่าสี่ค่า และชื่อที่ eBay ใช้เรียก
App ID คือรหัสไคลเอนต์ Cert ID คือข้อมูลลับของไคลเอนต์ ทั้งสองค่าอยู่ในพอร์ทัลนักพัฒนา eBay ใต้ บัญชีของฉัน → คีย์แอปพลิเคชัน และทั้งคู่คัดลอกแล้ววางได้เลย
RuName คือค่าที่ทำให้หลายคนติดขัด จึงมีหัวข้อแยกของตัวเองด้านล่าง
รหัสมาร์เก็ตเพลซ ใช้เลือกว่าคุณทำงานบนเว็บไซต์ eBay แห่งใด และต้องตรงกับโลแคลที่มาร์เก็ตเพลซนั้นรองรับ ส่วนใหญ่ก็เข้าใจได้ง่าย จนกว่าจะเจอกรณีที่ไม่เป็นเช่นนั้น eBay กำหนดให้ใช้ en-US สำหรับมาเลเซียและสิงคโปร์ ซึ่งเป็นรายละเอียดประเภทที่คุณมักรู้จากข้อความผิดพลาด แทนที่จะรู้จากคู่มือ
RuName เป็นชื่อ ไม่ใช่ที่อยู่
ในพอร์ทัลนักพัฒนา ไปที่ ชุดคีย์ → โทเคนผู้ใช้ → รับโทเคนผ่านแอปพลิเคชันของคุณ แล้วสร้างหรือเปิดรายการ URL เปลี่ยนเส้นทาง ในรายการนั้น ให้ตั้งค่า “URL ของคุณเมื่อยอมรับการอนุญาต” เป็นที่อยู่คอลแบ็กของไคลเอนต์ที่คุณกำลังเชื่อมต่อ Orkas ใช้ https://orkas.ai/api/connectors/oauth/dcr-callback และคุณไม่จำเป็นต้องมีเซิร์ฟเวอร์ของตัวเอง
จากนั้น — และนี่คือขั้นตอนสำคัญ — ให้คุณคัดลอก RuName ที่ eBay สร้างไว้สำหรับรายการนั้น เป็นสตริงสั้น ๆ ที่อ่านแล้วไม่สื่อความหมาย อยู่ข้าง URL ที่คุณเพิ่งพิมพ์ ช่องที่ต้องกรอกค่านี้อยู่ท่ามกลางช่อง URL คุณจึงมักเผลอวาง URL ซ้ำลงไป ซึ่งจะไม่ผ่านการอนุญาต และข้อความผิดพลาดที่ได้รับก็ไม่ได้บอกสาเหตุ
Sandbox ไม่ใช่ทางลัด
eBay มี sandbox ที่ใช้เพียงบัญชีนักพัฒนาฟรี โดยไม่ต้องมีบัญชีผู้ขายที่มีสถานะปกติ และมีประโยชน์จริงสำหรับเรียนรู้โครงสร้างของ API แต่ไม่ช่วยในเรื่องที่คุณต้องการจริง ๆ ซึ่งก็คือรายการสินค้าและคำสั่งซื้อของคุณเอง ข้อมูลใน sandbox เป็นข้อมูลจำลอง
การเชื่อมต่อใหม่ใน Orkas ใช้ระบบ production เท่านั้น นั่นหมายความว่าการสมัคร eBay Developers Program — แอปที่มีสิทธิ์เข้าถึงบัญชีผู้ขาย สินค้าคงคลัง รายการสินค้า และการจัดการคำสั่งซื้อ พร้อม Production Keyset — คือส่วนที่ใช้เวลานานที่สุดในการตั้งค่านี้ ไม่ใช่ไคลเอนต์ที่คุณเลือกภายหลัง เริ่มสมัครไว้แต่เนิ่น ๆ ส่วน คู่มือการอนุญาตอย่างเป็นทางการ ก็ควรอ่านระหว่างรอผลการสมัคร
การอ่านไม่ใช่การเขียน
เมื่อมีชุดคีย์แล้ว รายการสิทธิ์จะเป็นตัวกำหนดว่าการเชื่อมต่อนั้นทำอะไรได้จริง การถามว่าสัปดาห์ที่แล้วขายอะไรไปบ้างคือการอ่านข้อมูล ส่วนการแก้ไขรายการสินค้า ปรับสินค้าคงคลัง หรือระบุว่าจัดส่งคำสั่งซื้อแล้วคือการเขียนข้อมูล ซึ่งต้องมีขอบเขตสิทธิ์ที่สอดคล้องกันบนแอป
บริการเชื่อม eBay กับ Claude แบบโฮสต์หลายแห่งออกแบบมาให้อ่านข้อมูลได้อย่างเดียว ซึ่งก็เป็นผลิตภัณฑ์ที่สมเหตุสมผล — เพียงแต่ไม่ใช่ผลิตภัณฑ์แบบเดียวกัน ตรวจสอบความสามารถด้านการเขียนข้อมูลก่อนทุ่มเวลาไปกับการสมัคร เพราะไม่ว่าเลือกแบบไหน ขั้นตอนการสมัครก่อนหน้านั้นก็เหมือนกัน
ตัวเชื่อมต่อ Orkas เรียกใช้ Sell APIs ของ production จากเครื่องของคุณเอง ข้อมูลรับรองถูกเข้ารหัสไว้ในอุปกรณ์ แทนที่จะอยู่ในไฟล์การตั้งค่าหรือเซิร์ฟเวอร์ของผู้อื่น และทุกอย่างที่เขียนข้อมูลลงบัญชีจริงต้องผ่านหน้าต่างขออนุญาตในไคลเอนต์ แทนการหวังให้โมเดลระมัดระวังเอง
เมื่อทางเลือกอื่นเหมาะกว่า
คุณต้องการเพียงรายงาน: ตัวเชื่อมต่อแบบโฮสต์ตั้งค่าน้อยกว่าและไม่ต้องติดตั้งอะไร คุณต้องการให้ทำงานตามกำหนดเวลาโดยไม่มีคนเฝ้า: นี่คือแอปพลิเคชันเดสก์ท็อป เมื่อปิดหน้าต่างแอปก็หยุดทำงาน งานที่ตั้งเวลาไว้บนเซิร์ฟเวอร์จึงเหมาะกว่า คุณยังอยู่ระหว่างเรียนรู้ API: ใช้ sandbox กับบัญชีนักพัฒนาฟรี และอย่าเพิ่งเชื่อมต่ออะไรกับบัญชีจริง
แค็ตตาล็อกเดียวกันนี้ ครอบคลุม Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce และแพลตฟอร์มจีน คุณจึงไม่ต้องเริ่มจัดการข้อมูลรับรองใหม่ทุกครั้งที่เพิ่มหน้าร้าน ส่วนบทความที่เกี่ยวข้องเกี่ยวกับ Etsy และ Shopify อธิบายเรื่องเดียวกันสำหรับสองแพลตฟอร์มนั้น