eBayAPI开发简介

eBayAPI开发简介主讲人：李伦辉Email:[e-mail]介绍eBay是全球最大的网上交易平台，淘宝与其类似，卖家可以注册进入售卖，买家可以位于世界各地。eBay站点22个站点–大体是根据国家来分，有的国家有两种语言，可以有两个站点，其中比较特殊的是eBayMotors站点，主要售卖汽车/摩托车及其配件。–每个站点有一个唯一的ID，和Globel-ID，分别用于不同的API–每个站点有自己使用的币种eBay子公司–Paypal在线支付平台–Shopping.com区域交易平台–Half.com书籍、音乐、影片、游戏等交易平台eBay售卖类型售卖方法ListingType主要有一口价和拍卖两种，eBay售卖叫做刊登，刊登上去的产品叫Item，每个Item有全球唯一的ItemID不管拍卖、一口价，到期都会下架刊登成功以后不能修改刊登状态，但可以修改时限eBay一口价/固定价FixedPriceItem/StoredFixedPrice（店铺，已经合并为FixedPriceItem）有时间限制，一般分成3天、7天、15天、30天、GTC(GoodTilCancel)等GTC比较特殊，每隔30天会自动Relist重登，重登后ItemID会改变GTC在数量=0时自动下架一口价与拍卖最主要的不同点：一口价支持Variation刊登，即多属性刊登，拍卖不支持eBay拍卖Auction也有时间限制，一般分成3天、7天、15天等，在时限范围内出价最高者胜出拍卖可以设置BestOffer议价（即还价，还价可以设置自动接受/拒绝的底价）也可以设置一口价（允许买家拍卖、或直接一口价买下），当被一口价买下立即下架eBayItem状态在线Active已售出Completed，售出并不一定代表成功付款已下线Ended每个Item一上线即被记录StartTime，下架时记录EndTimeeBay分类每个站点的分类都不一样，在站点内，分类具有唯一ID不同分类开启了不同的功能，比如是否支持Variation/Specification/BestOffer/Condition必填等，所有设置都是API返回刊登时可以选择两个分类，所有功能设置以主分类为主。eBay属性(Specification)属性=分类属性，即在该分类下产品都有的特性。属性的设置优化了eBay网站的精确筛选。不同的分类有不同的属性，具体选项由API返回。eBay多属性(Variation)多属性刊登=SellerCube里的POA设置，即一个产品拥有多种颜色、尺寸，可以由顾客选择购买。Variation包括三部分：VariationSpecificsSet(VSS)、Variation(V)、Pictures(P）VSS：所有属性的名值对V：单个产品的所有属性，包括了SKU、数量、售价P:所有图片，当在eBay网站切换属性时，图片会相应改变eBay买家如何收款?所有eBay站点必须使用Paypal收款Paypal是全球最大的支付工具之一，Paypal是eBay子公司。开通eBay账号后，必须绑定Paypal账号才能刊登产品，刊登后产生的费用和成功的费用都直接转入Paypal。Paypal账号是一个邮件地址eBay如何处理发货？每个站点拥有一定数量的系统定义运输方式可选，运输方式分本地、国际，需由API定期同步。顾客购买时先选择运输方式，生成交易/订单时会保存选择的运输方式。eBay运输方式运输方式拥有唯一代码可以设置运费/免运费，还可以设置额外费用AdditionalCost本土运输方式有一个特殊的费用Surcharge，仅针对使用UPS/FedEx发往Alaska、Hawaii、PuertoRico，要求是US站点或eBayMotors站点的PartsandAccessories分类下的产品。国际运输方式还可以单独设置发往地eBay限制发往地发往地区ShipToLocations，只发往选择内的地区排除发往地区ExcludeShipToLocation，限制发往选择内的地区国际运输方式内的ShipToLocation，单独设置每个运输方式发往地区eBay订单是怎样的?1/2订单称为Order/交易Transaction–当有多条时称为Order–当只有单条时称为Transaction不区分主单与明细，由TransactionID+ItemID来区分是否唯一最新版本使用OrderLineItemID一个字段来表示，它合并了上面两个字段顾客在哪个站点上购买TransactionSiteID购买数量QuantityPurchased付款时间PaidTime最近修改时间LastTimeModifiedeBay订单是怎样的?2/2付款状态CheckoutStatus–CheckoutComplete付款完成–CheckoutIncomplete付款未完成–BuyerRequestsTotal买家要求合并订单–SellerResponded卖家已回复完成状态CompleteStatus–Complete已完成–Incomplete未完成–Pending等待中支付状态eBayPaymentStatus–NoPaymentFailure无错误–BuyerCreditCardFailed信用卡错误–BuyerECheckBounced电子支票打回–BuyerFailedPaymentReportedBySeller卖家拒绝–PaymentInProcess处理中–PayPalPaymentInProcessPaypal处理中eBay名称解释1SYI(SellYourItem)=刊登RYI(ReviseYourItem)=修改Relist=重登ItemID=全球唯一ItemIDTransaction=订单/交易Site=站点Location=发货地(其实是Country，只是内部使用)，真实发货地由Country/PostalCode/Location组成eBay名称解释2ListingType=刊登类型Duration=刊登时间限制ListingStatus=刊登状态Relist=基于原来的Item，重新发布，原来的Item会注明RelisedItemID，新Item会带上RelistParentIDStartPrice=一口价时的售价，拍卖里的竞拍价BuyItNowPrice(BIN)=拍卖时的一口价ReservePrice=底价eBay名称解释3BestOffer=议价Condition=物品状态（新/旧/...）DispatchTimeMax=发货天数，即处理订单到发货的时间，发货信息必须回传到eBayGetItFast=快速寄运=一天发货Category=分类，有两个PrimaryCategory+SecondaryCategory，一般只填一个StoreCategory=店铺分类，有两个eBay名称解释4HitCounter=点击计数器HitCount=点击次数Specification=属性ListingEnhancement=推广/广告功能，如加粗字体，加框等Quantity=刊登数量QuantityAvailable=可用数量，刊登数量已售出数量Bidder=拍卖竞标Markdown=PromotionalSale=折扣eBayAPI平台概览FindingAPI搜索TradingAPI最基本，使用最多的APIPlatformNotificationsAPI通知平台LargeMerchantServices大批量操作BestMatchAPI排名ProductServices什么是eBayAPIeBay提供API，可供开发者构建可与eBay平台整合的应用程序。开发者可根据自身需求，在符合eBay规范的基础上开发出符合自身需求的应用。例如:可自定义刊登规则，批量操作等等。使用eBayAPI能够实现哪些功能？在eBay上搜索及购买商品刊登商品、商品管理及库存管理管理销售订单与卖家、买家进行沟通查看eBay账户情况进行站点设置使用eBayAPI，你可以开发出一套几乎重现eBay所有功能的应用程序！eBayAPI可以制作哪些应用程序？TradingAPI创建新的在线商品获取在线商品信息获取eBayCategory结构获取与商品相关的事件获取指定商品相关交易信息获取指定卖家交易信息获取用户信息沟通及纠纷处理提供了安全的、需要认证的平台，用于操作及获取用户数据。eBayAPI的调用方式调用分SOAP/XML两种方式上传图片时必须使用XML方式SOAP–测试环境–生产环境XML–测试环境–生产环境开发步骤开发者网站：申请开发者账号，得到DevID/AppID/CertID进入沙盒环境申请模拟账号获取授权令牌Token建立工程，链接eBayAPIWebservice访问WebService调用APIAPITestTool=开发者后台测试工具大部分API需传入SiteID，以指定要操作是哪个站点1234DevIDAppIDCertIDTokenWebServiceSchemaWebServiceAPICalleBayAPI开发正式授权流程GetSessionID获取SessionID使用SessionID构造URL，转到此URL，让用户登陆用户登陆完成，点击“IAgrees”返回到程序页面（由开发者网站后台设置返回URL，必须为SSL）通过传递回来的SecretID+SessionID得到Token1234GetSessionIDURLFetchToken登陆IAgreeeBayAPI注意事项DetailLevel用于控制返回信息，返回信息可以是Always/Conditionally，Always会一定返回，Conditionally会视DetailLevel的设置而决定是否返回OutputSelector用于控制需要返回的具体字段，建议使用，数据量越小快速越快。Ack=请求返回状态–Success成功–PartialSuccess部分成功–Warning警告–Failure失败Error=错误消息–ErrorCode错误代号–LongMessage长消息–ShortMessage短消息eBay授权相关APIGetSessionID获取SessionIDFetchToken得到TokenGetTokenStatus获取Token状态RevokeToken取消授权eBay刊登涉及的APIAddItemAddFixedPriceItemVerifyAddItem验证VerifyAddFixedPriceItemRelistItem重登RelistFixedPriceItemVerifyRelistItemeBay结束刊登APIEndItem下架EndFixedPriceItemEndItemseBay获取Item资料APIGetItem获取详细资料GetItemsAwaitingFeedback获取等待留评价的ItemGetItemShipping获取运费GetSellerList按修改时间获取列表eBay修改Item资料APIReviseItem修改Item