eBayAPI開發(fā)簡(jiǎn)介

1、eBay API開發(fā)簡(jiǎn)介Email:1eBay介紹eBay是全球最大的網(wǎng)上交易平臺(tái),淘寶與其類似,賣家可以注冊(cè)進(jìn)入售賣,買家可以位于世界各地。2eBay站點(diǎn)22個(gè)站點(diǎn)大體是根據(jù)國(guó)家來分,有的國(guó)家有兩種語言,可以有兩個(gè)站點(diǎn),其中比較特殊的是eBayMotors站點(diǎn),主要售賣汽車/摩托車及其配件。每個(gè)站點(diǎn)有一個(gè)唯一的ID,和Globel-ID,分別用于不同的API每個(gè)站點(diǎn)有自己使用的幣種eBay子公司Paypal 在線支付平臺(tái)S 區(qū)域交易平臺(tái)H 書籍、音樂、影片、游戲等交易平臺(tái)3eBay售賣類型售賣方法ListingType 主要有一口價(jià)和拍賣兩種,eBay售賣叫做刊登,刊登上去的產(chǎn)品叫Item,

2、每個(gè)Item有全球唯一的Item ID不管拍賣、一口價(jià),到期都會(huì)下架刊登成功以后不能修改刊登狀態(tài),但可以修改時(shí)限4eBay一口價(jià)/固定價(jià)FixedPriceItem/StoredFixedPrice（店鋪,已經(jīng)合并為FixedPriceItem）有時(shí)間限制,一般分成3天、7天、15天、30天、GTC(Good Til Cancel)等GTC比較特殊,每隔30天會(huì)自動(dòng)Relist重登,重登后Item ID會(huì)改變GTC在 數(shù)量=0 時(shí)自動(dòng)下架一口價(jià)與拍賣最主要的不同點(diǎn)：一口價(jià)支持Variation刊登,即多屬性刊登,拍賣不支持5eBay拍賣Auction也有時(shí)間限制,一般分成3天、7天、15天等,

3、在時(shí)限范圍內(nèi)出價(jià)最高者勝出拍賣可以設(shè)置BestOffer議價(jià)（即還價(jià),還價(jià)可以設(shè)置自動(dòng)接受/拒絕的底價(jià)）也可以設(shè)置一口價(jià)（允許買家拍賣、或直接一口價(jià)買下）,當(dāng)被一口價(jià)買下立即下架6eBay Item狀態(tài)在線 Active已售出 Completed,售出并不一定代表成功付款已下線 Ended每個(gè)Item一上線即被記錄 StartTime,下架時(shí)記錄 EndTime7eBay分類每個(gè)站點(diǎn)的分類都不一樣,在站點(diǎn)內(nèi),分類具有唯一ID不同分類開啟了不同的功能,比方是否支持Variation/Specification/BestOffer/Condition必填等,所有設(shè)置都是API返回刊登時(shí)可以選擇兩個(gè)

4、分類,所有功能設(shè)置以主分類為主。8eBay屬性(Specification)屬性 = 分類屬性,即在該分類下產(chǎn)品都有的特性。屬性的設(shè)置優(yōu)化了eBay網(wǎng)站的精確篩選。不同的分類有不同的屬性,具體選項(xiàng)由API返回。9eBay多屬性(Variation)多屬性刊登 = SellerCube里的POA設(shè)置,即一個(gè)產(chǎn)品擁有多種顏色、尺寸,可以由顧客選擇購置。Variation包括三局部：VariationSpecificsSet(VSS)、Variation(V)、Pictures(P）VSS： 所有屬性的名值對(duì)V：?jiǎn)蝹€(gè)產(chǎn)品的所有屬性,包括了SKU、數(shù)量、售價(jià)P: 所有圖片,當(dāng)在eBay網(wǎng)站切換屬性時(shí),

5、圖片會(huì)相應(yīng)改變10eBay買家如何收款?所有eBay站點(diǎn)必須使用Paypal收款Paypal是全球最大的支付工具之一,Paypal是eBay子公司。開通eBay賬號(hào)后,必須綁定Paypal賬號(hào)才能刊登產(chǎn)品,刊登后產(chǎn)生的費(fèi)用和成功的費(fèi)用都直接轉(zhuǎn)入Paypal。Paypal賬號(hào)是一個(gè)郵件地址11eBay如何處理發(fā)貨？每個(gè)站點(diǎn)擁有一定數(shù)量的系統(tǒng)定義運(yùn)輸方式可選,運(yùn)輸方式分本地、國(guó)際,需由API定期同步。顧客購置時(shí)先選擇運(yùn)輸方式,生成交易/訂單時(shí)會(huì)保存選擇的運(yùn)輸方式。12eBay運(yùn)輸方式運(yùn)輸方式擁有唯一代碼可以設(shè)置運(yùn)費(fèi)/免運(yùn)費(fèi),還可以設(shè)置額外費(fèi)用AdditionalCost外鄉(xiāng)運(yùn)輸方式有一個(gè)特殊的費(fèi)用

6、Surcharge,僅針對(duì)使用UPS/FedEx發(fā)往Alaska、Hawaii、Puerto Rico,要求是US站點(diǎn)或eBayMotors站點(diǎn)的Parts and Accessories分類下的產(chǎn)品。國(guó)際運(yùn)輸方式還可以單獨(dú)設(shè)置發(fā)往地13eBay限制發(fā)往地發(fā)往地區(qū) ShipToLocations,只發(fā)往選擇內(nèi)的地區(qū)排除發(fā)往地區(qū) ExcludeShipToLocation,限制發(fā)往選擇內(nèi)的地區(qū)國(guó)際運(yùn)輸方式內(nèi)的ShipToLocation,單獨(dú)設(shè)置每個(gè)運(yùn)輸方式發(fā)往地區(qū)14eBay訂單是怎樣的?1/2訂單稱為Order/交易Transaction當(dāng)有多條時(shí)稱為Order當(dāng)只有單條時(shí)稱為Transac

7、tion不區(qū)分主單與明細(xì),由TransactionID + ItemID來區(qū)分是否唯一最新版本使用OrderLineItemID一個(gè)字段來表示,它合并了上面兩個(gè)字段顧客在哪個(gè)站點(diǎn)上購置 TransactionSiteID購置數(shù)量 QuantityPurchased付款時(shí)間 PaidTime最近修改時(shí)間 LastTimeModified 15eBay訂單是怎樣的?2/2付款狀態(tài) CheckoutStatus CheckoutComplete 付款完成 CheckoutIncomplete 付款未完成 BuyerRequestsTotal 買家要求合并訂單 SellerResponded 賣家已回

8、復(fù)完成狀態(tài) CompleteStatus Complete 已完成 Incomplete 未完成 Pending 等待中支付狀態(tài) eBayPaymentStatus NoPaymentFailure 無錯(cuò)誤 BuyerCreditCardFailed 信用卡錯(cuò)誤 BuyerECheckBounced 電子支票打回 BuyerFailedPaymentReportedBySeller 賣家拒絕 PaymentInProcess 處理中 PayPalPaymentInProcess Paypal處理中16eBay名稱解釋1SYI(Sell Your Item) = 刊登RYI(Revise You

9、r Item) = 修改Relist = 重登ItemID = 全球唯一Item IDTransaction = 訂單/交易Site = 站點(diǎn)Location = 發(fā)貨地(其實(shí)是Country,只是內(nèi)部使用),真實(shí)發(fā)貨地由Country/PostalCode/Location組成17eBay名稱解釋2ListingType = 刊登類型Duration = 刊登時(shí)間限制ListingStatus = 刊登狀態(tài)Relist = 基于原來的Item,重新發(fā)布,原來的Item會(huì)注明RelisedItemID,新Item會(huì)帶上RelistParentIDStartPrice = 一口價(jià)時(shí)的售價(jià),拍賣里

10、的競(jìng)拍價(jià)BuyItNowPrice(BIN) = 拍賣時(shí)的一口價(jià)ReservePrice = 底價(jià)18eBay名稱解釋3BestOffer = 議價(jià)Condition = 物品狀態(tài)（新/舊/.）DispatchTimeMax = 發(fā)貨天數(shù),即處理訂單到發(fā)貨的時(shí)間,發(fā)貨信息必須回傳到eBayGetItFast = 快速寄運(yùn) = 一天發(fā)貨Category = 分類,有兩個(gè)PrimaryCategory + SecondaryCategory,一般只填一個(gè)StoreCategory = 店鋪分類,有兩個(gè)19eBay名稱解釋4HitCounter = 點(diǎn)擊計(jì)數(shù)器HitCount = 點(diǎn)擊次數(shù)Speci

11、fication = 屬性ListingEnhancement = 推廣/廣告功能,如加粗字體,加框等Quantity = 刊登數(shù)量QuantityAvailable = 可用數(shù)量,刊登數(shù)量 已售出數(shù)量Bidder = 拍賣競(jìng)標(biāo)Markdown = PromotionalSale = 折扣20eBay API平臺(tái)概覽Finding API 搜索Trading API 最根本,使用最多的APIPlatform Notifications API 通知平臺(tái)Large Merchant Services 大批量操作Best Match API 排名Product Services21什么是eBay

12、APIeBay提供API,可供開發(fā)者構(gòu)建可與eBay平臺(tái)整合的應(yīng)用程序。開發(fā)者可根據(jù)自身需求,在符合eBay標(biāo)準(zhǔn)的根底上開發(fā)出符合自身需求的應(yīng)用。例如:可自定義刊登規(guī)則,批量操作等等。22使用eBay API能夠?qū)崿F(xiàn)哪些功能？在eBay上搜索及購置商品刊登商品、商品管理及庫存管理管理銷售訂單與賣家、買家進(jìn)行溝通查看eBay賬戶情況進(jìn)行站點(diǎn)設(shè)置使用eBay API,你可以開發(fā)出一套幾乎重現(xiàn)eBay所有功能的應(yīng)用程序！23eBay API可以制作哪些應(yīng)用程序？24Trading API創(chuàng)立新的在線商品獲取在線商品信息獲取eBay Category結(jié)構(gòu)獲取與商品相關(guān)的事件獲取指定商品相關(guān)交易信息獲取

13、指定賣家交易信息獲取用戶信息溝通及糾紛處理提供了平安的、需要認(rèn)證的平臺(tái),用于操作及獲取用戶數(shù)據(jù)。25eBay API的調(diào)用方式調(diào)用分SOAP/XML兩種方式上傳圖片時(shí)必須使用XML方式SOAP 測(cè)試環(huán)境 生產(chǎn)環(huán)境 XML 測(cè)試環(huán)境 生產(chǎn)環(huán)境 26eBay API開發(fā)步驟開發(fā)者網(wǎng)站：申請(qǐng)開發(fā)者賬號(hào),得到DevID/AppID/CertID進(jìn)入沙盒環(huán)境申請(qǐng)模擬賬號(hào) 獲取授權(quán)令牌Token建立工程,鏈接eBay API Web service訪問Web Service調(diào)用APIAPI Test Tool = 開發(fā)者后臺(tái)測(cè)試工具大局部API需傳入SiteID,以指定要操作是哪個(gè)站點(diǎn)1234DevIDA

14、ppIDCertIDTokenWeb Service SchemaWeb Service API Call27eBay API開發(fā)正式授權(quán)流程GetSessionID獲取Session ID使用Session ID構(gòu)造URL,轉(zhuǎn)到此URL,讓用戶登陸用戶登陸完成,點(diǎn)擊“I Agrees返回到程序頁面（由開發(fā)者網(wǎng)站后臺(tái)設(shè)置返回URL,必須為SSL）通過傳遞回來的Secret ID + Session ID得到Token1234GetSessionID URL FetchToken登陸I Agree28eBay API本卷須知DetailLevel 用于控制返回信息,返回信息可以是Always/C

15、onditionally,Always會(huì)一定返回, Conditionally會(huì)視DetailLevel的設(shè)置而決定是否返回OutputSelector 用于控制需要返回的具體字段,建議使用,數(shù)據(jù)量越小快速越快。Ack = 請(qǐng)求返回狀態(tài)Success 成功PartialSuccess 局部成功Warning 警告Failure 失敗Error = 錯(cuò)誤消息ErrorCode 錯(cuò)誤代號(hào)LongMessage 長(zhǎng)消息ShortMessage 短消息29eBay授權(quán)相關(guān)APIGetSessionID 獲取Session IDFetchToken 得到TokenGetTokenStatus 獲取Tok

16、en狀態(tài)RevokeToken 取消授權(quán)30eBay刊登涉及的APIAddItem AddFixedPriceItemVerifyAddItem 驗(yàn)證VerifyAddFixedPriceItemRelistItem 重登RelistFixedPriceItemVerifyRelistItem31eBay結(jié)束刊登APIEndItem 下架EndFixedPriceItemEndItems32eBay獲取Item資料APIGetItem 獲取詳細(xì)資料GetItemsAwaitingFeedback 獲取等待留評(píng)價(jià)的ItemGetItemShipping 獲取運(yùn)費(fèi)GetSellerList 按修改時(shí)間獲取列表33eBay修改Item資料APIReviseItem 修改ItemReviseFixedPriceItemReviseInventoryStatus 修改庫存AddToItemDescription 追加描述34eBay交易相關(guān)APIGetItemTransactions 獲取交易GetOrderTransactions 獲取訂單GetSellerTransactions 獲取賣家交易（不常用）CompleteSale