Ebay Trading API整理
糾紛相關
AddDispute:創建一個未支付糾紛 或 取消 a single line item order
AddDisputeResponse:回復/關閉dispute
GetDispute:獲取Dispute
GetUserDisputes :獲取用戶作為買家或賣家的Dispute
商品相關
AddItem:添加一個item
AddItemFromSellingManagerTemplate:從Selling Manager templates創建 listing
AddItems:上傳1到5個item
AddToWatchList:添加一個或多個item到 My eBay watch list
DisableUnpaidItemAssistance:禁用Unpaid Item Assistant
EndFixedPriceItem:下架fixed-price item
EndItem:下架item
EndItems: 下架10個 items
GetBestOffers:獲取商品的Best Offers
GetBidderList:獲取用戶正在拍、已拍到和已購買的商品
GetItem:Returns item data
GetItemsAwaitingFeedback:返回等待買家或賣家回復feedback的items
GetMyeBayBuying:從My eBay account>Buying section獲取watching、biding on、 has won、has made Best Offers 的 item
GetMyeBaySelling:從My eBay account>Selling section獲取user is currently selling (the Active list),items that have bids, sold items, and unsold items.
GetSellingManagerSoldListings:獲取已賣掉的商品的信息
RelistFixedPriceItem:重新上傳a single fixed-price item 或者 a single multi-item listing 到指定的網站
RelistItem:重新上傳a single item 或者 a single multi-item listing 到指定的網站
RemoveFromWatchList:remove one or more items from My eBay watch list
RespondToBestOffer:接受、拒絕 或 買方還價 => Best Offer
ReviseFixedPriceItem:修改active的 fixed-price item 屬性
ReviseInventoryStatus:change the price and quantity of currently active fixed-price items
ReviseItem:修改active listing 屬性
VerifyRelistItem:驗證重新上傳Item
區別ReviseFixedPriceItem、ReviseInventoryStatus、ReviseItem
ReviseFixedPriceItem :
1、basic fixed-price listings and store inventory listings
2、gives you an option to track inventory by SKU instead of by ItemID
3、supports the revising of multi-varation listings
4、you can revise items in bulk by using the File Transfer API and Bulk Data Exchange API
ReviseItem :auctions, classified ads, or listings with Best Offer
VerifyAddFixedPriceItem:並不真正上傳商品,只是測試一下商品的信息,返回上傳需要的價格等信息,供賣家參考
訂單相關
AddSecondChanceItem:給予未競拍成功的買家第二次競拍的機會
VerifyAddSecondChanceItem:驗證AddSecondChanceItem的輸入參數,返回模擬的start and end times
AddOrder:合並多個訂單,方便買家支付
AddTransactionConfirmationItem:
CompleteSale:在創建了a single line item or multiple line item order,買家做various tasks
GetItemTransactions:返回指定商品的訂單
GetOrders:獲取身份驗證用戶的訂單,既包括買家也包括賣家
GetOrderTransactions:根據OrderIDs, ItemIDs, or SKU獲取一個或多個訂單的信息
GetSellerTransactions:As a seller, you can use this call to retrieve all of your order line items
PlaceOffer:make a bid, a best offer, or a purchase on the item specified by the ItemID input field
Message相關
DeleteMyMessages:為用戶刪除選擇的messages
GetMemberMessages:獲取買家對你的active item的message
GetMessagePreferences:獲取賣家的 Ask Seller a Question (ASQ)
GetMyMessages:獲取我的messages
Category相關
GetCategories:獲取最新的catgories
GetCategoryFeatures:根據不同的category獲取想應的 listing durations, shipping term requirements 和 Best Offer support
GetCategoryMappings:獲取久category IDs 和新 category IDs 的映射
GetCategorySpecifics:獲取category 的 item specifics
GetSuggestedCategories:根據關鍵字獲取10個相關的category
SetStoreCategories:改變caller的eBay store 的 category配置信息
Feedback相關
GetFeedback:獲取用戶或商品或訂單的feedback
LeaveFeedback:買/賣家評價
RespondToFeedback:回復feedback或追加后續評論
其他接口
AddSellingManagerInventoryFolder:為用戶的Selling Manager account添加一個新的product文件夾
AddSellingManagerProduct:創建一個包含可以重復listing產品模板的Selling Manager product
AddSellingManagerTemplate:添加一個Selling Manager template
AddMemberMessageAAQToPartner:使買家和賣家按一定順序關系,發送message到彼此的My Messages Inboxes
AddMemberMessageRTQ:讓賣家對於an active item回復問題
AddMemberMessagesAAQToBidder:賣家給競拍者或提出Best Offer的買家發送10條message
ConfirmIdentity:返回已經通過應用程序的同意流程獲得授權token的用戶ID
DeleteSellingManagerInventoryFolder:刪除銷售庫存管理文件夾
DeleteSellingManagerItemAutomationRule:刪除一個產品和Selling Manager automation rules的聯系
DeleteSellingManagerProduct:刪除一個Selling Manager product
DeleteSellingManagerTemplate:刪除一個Selling Manager template
DeleteSellingManagerTemplateAutomationRule:刪除一個template和Selling Manager automation rules的聯系
FetchToken:檢索用戶的認證token
GetAccount:獲取包括匯總數據在內的eBay account的發票數據
GetAdFormatLeads:Retrieves sales lead information for a lead generation listing.
GetAllBidders:提供三種模式獲取用戶的拍賣信息
GetApiAccessRules:Use this call to report on how many calls your application has made and how many it is allowed to make
GetChallengeToken:Retrieves a botblock token and URLs for an image or audio clip that the user is to match.
GetCharities:獲得慈善機構
GetClientAlertsAuthToken:Retrieves a token required for the GetUserAlerts call in the Client Alerts API.
GeteBayDetails:根據不同的DetailName獲取不同的eBay 詳情信息
GeteBayOfficialTime:獲取eBay系統的格林威治時間
GetItemShipping:返回賣家提供的商品運輸服務
GetMyeBayReminders:從My eBay account 獲取所有的Buying和Selling 提醒
GetPromotionalSaleDetails:獲取促銷信息
GetSellerDashboard:獲取賣家的一個簡短的介紹
GetSellerEvents:獲取賣家48小時內的 price changes, item 修改, description 修改, and other changes
GetSellingManagerInventory:分頁獲取銷售庫存管理
GetSellingManagerInventoryFolder:獲取銷售庫存管理文件夾
GetSellingManagerItemAutomationRule:獲取銷售管理自動化規則,這個規則可以自動商品上架、保證active商品個數等
GetSellingManagerSaleRecord:獲取銷售管理記錄
GetSellingManagerTemplateAutomationRule:獲取銷售模板管理自動化規則
GetSessionID:獲取一個session ID,用來創建token(待看)
GetStore:通過UserID或者caller獲取eBay store 的配置信息
GetStoreOptions:eBay商店配置設置的當前列表
GetStorePreferences:用戶的eBay Store的喜好
GetTaxTable:獲取某一網站的稅表
GetUser:獲取有關單一eBay用戶的數據
GetUserPreferences:獲取用戶的喜好
MoveSellingManagerInventoryFolder:移動Selling Manager inventory folder
ReviseCheckoutStatus:use this call to update the payment details, the shipping details, and the status of an order
ReviseSellingManagerInventoryFolder
ReviseSellingManagerSaleRecord
RevokeToken:撤銷token
SaveItemToSellingManagerTemplate
SendInvoice:賣家發送發票給買家
SetPromotionalSale:Promotional sales enable sellers to apply discounts and/or free shipping across many listings
SetPromotionalSaleListings:改變被promotional sale影響到的item
SetSellingManagerFeedbackOptions
SetSellingManagerItemAutomationRule
SetSellingManagerTemplateAutomationRule
SetShippingDiscountProfiles:設置運費折扣文件
SetStore:設置caller的eBay store 的配置信息
SetStoreCustomPage:Creates or updates a custom page on a user's eBay Store.
SetStorePreferences:設置user's eBay Store喜好
SetTaxTable:設置賣家給定的網站的稅表
SetUserNotes:add, replace, and delete My eBay notes for items that are being tracked in the My eBay All Selling and All Buying areas
Uploads a picture to the eBay Picture Service and returns a URL for the picture.
1、沒有獲取上傳圖片的API,所以返回的圖片地址要保存好
2、圖片上傳5天內不用來上傳商品或者10天內沒調用Large Merchant Service上傳商品,圖片會被刪除
3、上傳附件不支持Large Merchant Service
4、eBay Picture Service(EPS)支持jpg、gif、png、bmp、tif格式,不支持psd等格式。
5、圖片最大7MB。
真正開始使用ebay api前,先申請兩套賬號,sandbox和真正ebay的。
sandbox賬號用來測試使用,申請過程請參考其官方文檔。
一般我們使用api最常用的操作無非就是上傳,更新,刪除這3種;其他功能如訂單的操作等,這里不再贅述。
先認識一些API CALL吧,因為ebay的API CALL種類繁多,這里只舉例一些常用的
添加新產品到ebay平台的有AddFixedPriceItem ,AddItem ,AddItems
AddFixedPriceItem 用於添加固定價格的產品到ebay,類似於淘寶一口價
AddItem 用於添加可變價格產品,類似於淘寶上的拍賣價
AddItems可批量添加產品到ebay,目前最多支持5個產品同時上傳
修復產品的有ReviseFixedPriceItem ,ReviseInventoryStatus, ReviseItem
ReviseFixedPriceItem 用於更新固定價格產品的屬性,如title,price,庫存等,適用於multi-variation產品
ReviseInventoryStatus, 只能改變固定價格產品的price和庫存
ReviseItem 更新可變價格產品的屬性,如title,price,庫存等,(固定價格產品未做測試)
清除產品得有EndFixedPriceItem EndItem EndItems
作用同上所述,不再贅述。
值得注意的是,ebay對上傳產品要求很嚴格,它會檢查你產品的所有屬性,不合格就不能通過。
比如title長度不能多於80個字符 title,description不能含有非法字符等等
這些CALL每24小時的總共調用限制是5000次,超過5000次將不能在使用,除非你向ebay申請更大的特權,申請后能達到每24小時使用500萬次。
ebay每上傳一個產品也是要收取手續費的,貌似是0.05美分,所以上傳前一定要確保你的產品是優化過的。