Về mặt khái niệm, khiến eBay giao tiếp với Claude không khó. Chỉ là một ứng dụng OAuth, bốn giá trị và một danh sách quyền. Khó ở chỗ eBay đặt tên những giá trị đó khác mọi sàn thương mại điện tử khác, và có một trường yêu cầu thứ trông hệt như URL nhưng lại không phải URL.
Bốn giá trị và cách eBay gọi chúng
App ID là mã định danh ứng dụng khách. Cert ID là khóa bí mật của ứng dụng khách. Cả hai đều nằm trong Cổng thông tin nhà phát triển eBay, ở Tài khoản của tôi → Khóa ứng dụng, và đều chỉ cần sao chép rồi dán.
RuName là giá trị khiến mọi người mắc kẹt, nên có phần riêng bên dưới.
Marketplace ID chọn trang eBay bạn hoạt động trên đó và phải khớp với một thiết lập ngôn ngữ-khu vực mà thị trường ấy hỗ trợ. Điều này phần lớn khá hiển nhiên — cho đến khi không còn như vậy. eBay quy định en-US cho Malaysia và Singapore, đúng kiểu chi tiết bạn phát hiện qua thông báo lỗi thay vì qua hướng dẫn.
RuName là tên, không phải địa chỉ
Trong cổng nhà phát triển, vào Bộ khóa → Token người dùng → Lấy token qua ứng dụng của bạn, rồi tạo hoặc mở một mục URL chuyển hướng. Trong mục đó, đặt “URL khi chấp thuận xác thực của bạn” thành địa chỉ gọi lại của ứng dụng khách bạn đang kết nối. Orkas dùng https://orkas.ai/api/connectors/oauth/dcr-callback, và bạn không cần máy chủ riêng để dùng địa chỉ này.
Sau đó — và đây là bước mấu chốt — bạn sao chép RuName mà eBay đã tạo cho mục đó. Đây là một chuỗi ngắn không mang ý nghĩa dễ đọc, nằm cạnh URL bạn vừa nhập. Trường yêu cầu nó được bao quanh bởi các trường URL, nên theo bản năng bạn sẽ dán lại URL. Làm vậy sẽ không cấp quyền được, và lỗi trả về không nói rõ lý do.
Môi trường thử nghiệm không phải đường tắt
eBay có môi trường thử nghiệm chỉ cần tài khoản nhà phát triển miễn phí, không cần tài khoản người bán đáp ứng đầy đủ yêu cầu, và nó thực sự hữu ích để tìm hiểu cấu trúc API. Nhưng nó không hữu ích cho điều bạn thực sự muốn: các tin đăng và đơn hàng của chính bạn. Dữ liệu thử nghiệm là dữ liệu giả lập.
Các kết nối mới trong Orkas chỉ dùng môi trường thực tế. Điều đó có nghĩa là hồ sơ đăng ký Chương trình Nhà phát triển eBay — một ứng dụng có quyền với tài khoản người bán, tồn kho, tin đăng và hoàn tất đơn hàng, cùng Bộ khóa môi trường thực tế — mới là phần mất thời gian nhất trong thiết lập này, không phải ứng dụng khách bạn chọn sau đó. Hãy bắt đầu sớm. Tài liệu hướng dẫn cấp quyền chính thức rất đáng đọc trong khi chờ hồ sơ được duyệt.
Đọc không phải ghi
Khi đã có bộ khóa, danh sách quyền quyết định kết nối thực sự dùng để làm gì. Hỏi tuần trước bán được gì là thao tác đọc. Sửa tin đăng, điều chỉnh tồn kho hoặc đánh dấu đơn hàng đã gửi là thao tác ghi, và cần các phạm vi quyền tương ứng trên ứng dụng.
Một số dịch vụ kết nối eBay với Claude được lưu trữ sẵn chỉ cho phép đọc theo thiết kế, và đó là một sản phẩm hợp lý — chỉ là không phải cùng một sản phẩm. Hãy kiểm tra khả năng ghi trước khi bỏ công đăng ký, vì dù chọn cách nào thì hồ sơ phải làm trước đó cũng giống nhau.
Trình kết nối Orkas làm việc với các Sell API trong môi trường thực tế từ chính máy của bạn. Thông tin xác thực được mã hóa trên thiết bị thay vì nằm trong tệp cấu hình hay trên máy chủ của người khác, và mọi thao tác ghi vào tài khoản thực đều phải qua lời nhắc cấp quyền trong ứng dụng khách, thay vì trông chờ mô hình tự thận trọng.
Khi giải pháp khác phù hợp hơn
Bạn chỉ muốn báo cáo: trình kết nối được lưu trữ sẵn cần ít thiết lập hơn và không phải cài đặt gì. Bạn muốn chạy theo lịch mà không có người giám sát: đây là ứng dụng máy tính, nên đóng cửa sổ sẽ khiến nó dừng; tác vụ theo lịch trên máy chủ mới là lựa chọn phù hợp. Bạn vẫn đang học API: hãy dùng môi trường thử nghiệm và tài khoản nhà phát triển miễn phí, chưa nên kết nối bất cứ thứ gì với tài khoản thực.
Cùng danh mục đó hỗ trợ Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce và các nền tảng Trung Quốc, nên bạn không phải bắt đầu lại việc xoay xở thông tin xác thực cho từng gian hàng. Các bài viết liên quan về Etsy và Shopify đề cập những nội dung tương tự cho hai nền tảng đó.