易貝（eBay）是一個(gè)在線拍賣(mài)和購(gòu)物網(wǎng)站，提供了一個(gè)API（應(yīng)用程序接口）供開(kāi)發(fā)者獲取商品詳情等信息。使用eBay的API，你可以編寫(xiě)應(yīng)用程序來(lái)查詢商品、檢索拍賣(mài)詳情、跟蹤訂單等。

當(dāng)你調(diào)用eBay的API獲取商品詳情時(shí)，通常會(huì)返回一個(gè)JSON或XML格式的響應(yīng)，這個(gè)響應(yīng)包含了商品的詳細(xì)信息。以下是一個(gè)簡(jiǎn)化的JSON格式的eBay商品詳情API返回值示例及說(shuō)明：

json
代碼解讀
復(fù)制代碼
{
 "ack": "Success",
 "version": "1.13.0",
 "timestamp": "2023-04-25T12:34:56.789Z",
 "build": "E1234567",
 "Item": {
   "ItemID": "123456789012",
   "Title": "Brand New Laptop",
   "PrimaryCategory": {
     "CategoryID": "12345",
     "CategoryName": "Laptops & Netbooks"
   },
   "StartPrice": {
     "currencyID": "USD",
     "__value__": "999.99"
   },
   "CurrentPrice": {
     "currencyID": "USD",
     "__value__": "999.99"
   },
   "HighBidder": {
     "UserID": "bidder123",
     "UserName": "HighBidderUser"
   },
   "QuantitySold": "10",
   "ListingInfo": {
     "ListingDuration": "GTC",
     "ListingType": "FixedPriceItem",
     "BestOfferEnabled": "false"
   },
   "PaymentMethods": "PayPal",
   "ShippingInfo": {
     "ShippingServiceCost": {
       "currencyID": "USD",
       "__value__": "0.00"
     },
     "ShipToLocations": "US",
     "ExpeditedShipping": "false"
   },
   "PictureURL": "https://example.com/item-picture.jpg",
   "ViewItemURLForNaturalSearch": "https://www.ebay.com/itm/Brand-New-Laptop/123456789012",
   "Description": "This is a brand new laptop computer...",
   "Seller": {
     "UserID": "seller123",
     "UserName": "SellerUser"
   }
   // 其他可能存在的字段，如Location, HandlingTime, ShippingIncludesInsurance等
 

返回值說(shuō)明：

ack: API調(diào)用的響應(yīng)狀態(tài)，通常是"Success"表示成功，"Failure"表示失敗。
version: API的版本號(hào)。
timestamp: 請(qǐng)求處理的時(shí)間戳。
build: eBay系統(tǒng)的構(gòu)建版本號(hào)。
Item: 商品信息對(duì)象。
ItemID: 商品的唯一ID。
Title: 商品標(biāo)題。
PrimaryCategory: 商品的主要分類(lèi)信息。
CategoryID: 分類(lèi)ID。
CategoryName: 分類(lèi)名稱(chēng)。
StartPrice: 商品的起始價(jià)格。
currencyID: 貨幣類(lèi)型，如USD。
__value__: 價(jià)格值。
CurrentPrice: 商品的當(dāng)前價(jià)格（對(duì)于固定價(jià)格商品或當(dāng)前競(jìng)拍價(jià)格）。
HighBidder: 當(dāng)前最高出價(jià)者的信息。
UserID: 出價(jià)者ID。
UserName: 出價(jià)者用戶名。
QuantitySold: 已售出的商品數(shù)量。
ListingInfo: 列表信息。
ListingDuration: 列表持續(xù)時(shí)間，如GTC（Good Until Canceled，直到取消為止）。
ListingType: 列表類(lèi)型，如FixedPriceItem（固定價(jià)格商品）。
BestOfferEnabled: 是否啟用“最佳報(bào)價(jià)”功能。
PaymentMethods: 支付方式，如PayPal。
ShippingInfo: 運(yùn)輸信息。
ShippingServiceCost: 運(yùn)輸服務(wù)費(fèi)用。
ShipToLocations: 可發(fā)貨地點(diǎn)。
ExpeditedShipping: 是否提供加急運(yùn)輸。
PictureURL: 商品的圖片URL。
ViewItemURLForNaturalSearch: 商品的自然搜索URL。
Description: 商品的描述。
Seller: 賣(mài)家信息。
UserID: 賣(mài)家ID。
UserName: 賣(mài)家用戶名。
請(qǐng)注意，實(shí)際的API返回值可能會(huì)比這個(gè)示例更加復(fù)雜，是的，我之前的示例只是一個(gè)簡(jiǎn)化的、概念性的返回值結(jié)構(gòu)。在實(shí)際使用中，EBAY商品詳情API的返回值可能會(huì)包含更多的字段和嵌套結(jié)構(gòu)，具體取決于你請(qǐng)求的商品和API的版本。

以下是一些可能存在的額外字段和結(jié)構(gòu)的例子：

json

代碼解讀

{
 "ack": "Success",
 "version": "1.0",
 "timestamp": "2023-04-01T12:34:56.789Z",
 "build": "E123456",
 "Item": {
   "ItemID": "123456789012",
   "Title": "Brand New Laptop",
   "PrimaryCategory": {
     "CategoryID": "1234",
     "CategoryName": "Laptops & Netbooks"
   },
   "SecondaryCategory": [
     {
       "CategoryID": "5678",
       "CategoryName": "Apple Laptops"
     },
     {
       "CategoryID": "9012",
       "CategoryName": "Business Laptops"
     }
   ],
   "StartPrice": {
     "currencyID": "USD",
     "__value__": "999.99"
   },
   "CurrentPrice": {
     "currencyID": "USD",
     "__value__": "999.99"
   },
   "HighBidder": {
     "UserID": "bidder123",
     "UserName": "HighBidderUser"
   },
   "QuantitySold": "10",
   "ReservePrice": {
     "currencyID": "USD",
     "__value__": "0.00"
   },
   "BidCount": "20",
   "SellingStatus": {
     "CurrentPrice": {
       "currencyID": "USD",
       "__value__": "999.99"
     },
     "ConvertedCurrentPrice": {
       "currencyID": "USD",
       "__value__": "999.99"
     },
     "TimeLeft": "P3DT6H23M59S"
   },
   "ListingInfo": {
     "ListingDuration": "GTC",
     "ListingType": "FixedPriceItem",
     "StartTime": "2023-04-01T00:00:00.000Z",
     "EndTime": "2023-05-01T00:00:00.000Z",
     "QuantityAvailable": "5",
     "BestOfferEnabled": "false",
     "BuyItNowAvailable": "true",
     "ConversionType": "FixedPrice"
   },
   "PaymentMethods": "PayPal, CreditCard",
   "PaymentInfo": {
     "PayPalAccepted": "true",
     "PayPalEmail": "seller@example.com"
   },
   "ShippingInfo": {
     "ShippingServiceCost": {
       "currencyID": "USD",
       "__value__": "10.00"
     },
     "ShipToLocations": "US, CA",
     "ExpeditedShipping": "true",
     "OneDayShippingAvailable": "false",
     "HandlingTime": "1"
   },
   "Location": "United States",
   "PictureURL": "https://example.com/item-picture.jpg",
   "GalleryURL": "https://example.com/gallery-picture.jpg",
   "ViewItemURLForNaturalSearch": "https://www.ebay.com/itm/Brand-New-Laptop/123456789012",
   "Description": "This is a brand new laptop computer...",
   "Seller": {
     "UserID": "seller123",
     "UserName": "SellerUser",
     "FeedbackScore": "98.5",
     "PositiveFeedbackPercent": "99"
   },
   "ReturnsAccepted": "true",
   "ConditionID": "1000",
   "ConditionDisplayName": "Brand New",
   "IsMultiVariationListing": "false",
   "Variations": [
     // 如果商品有多個(gè)變體，這里會(huì)列出每個(gè)變體的信息
   ],
   "SKU": "LAPTOP-001",
   "MPN": "LNX-MNXB2",
   "Brand":

審核編輯 黃宇