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:创建一个包含可以重复listin*品模板的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美分,所以上传前一定要确保你的产品是优化过的。