如何获取易贝EBAY商品详情 API 返回值说明？

item_get-获得EBAY商品详情

ebay.item_get

公共参数

请求地址: https://api-gw-4.cn/ebay/item_get

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=331712743699

参数说明：num_iid:EBAY商品ID

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	392263751757	商品ID
detail_url	String	0	https://www.ebay.com/itm/0-/392263751757	商品链接
condition	String	0	Pre-owned	状态
watching	String	0
why2buy	Mix	0	["Longtime member"]
crumbs	Mix	0	"3034": "女鞋", "11450": "服装、鞋和配件", "95672": "运动鞋"	导航菜单
title	String	0	Saucony Oasis Aqua Neon运动跑步鞋SZ 8.5	商品标题
desc_short	String	0		商品简介
brand	String	0	Saucony	品牌
brandId	String	0		品牌ID
rootCatId	String	0	11450	顶级分类ID
cid	String	0	95672
pic_url	String	0		商品图片
item_imgs	Mix	0	[]	商品图片列表
nick	String	0	usauk2008	掌柜昵称
num	Int	0	99
sales	Int	0		销量
price	Float	0	8.99	价格
orginal_price	String	0		原价
type	String	0
seller_cids	String	0
input_pids	String	0
input_str	String	0
item_weight	String	0
valid_thru	String	0
delist_time	String	0
desc	String	0
delivery	String	0
guarantee	String	0
returns	String	0	Seller does not accept returns
stuff_status	String	0
location	String	0	Norwich, New York, United States	发货地
express_fee	String	0		快递费用
ems_fee	Float	0	371.13	EMS费用
post_fee	String	0		物流费用
shipping_to	String	0	Worldwide	发货至
has_discount	String	0
freight_payer	String	0
has_invoice	String	0
has_warranty	String	0
has_showcase	String	0
increment	String	0
approve_status	String	0
postage_id	String	0
product_id	String	0
auction_point	String	0
item_img	String	0
prop_imgs	Mix	0	{"prop_img": []}	商品属性图片列表
props_img	Mix	0	[]
sku	String	0		商品规格信息列表
video	Mix	0	[]	商品视频
outer_id	String	0
is_virtual	String	0
sample_id	String	0		商品风格标识ID
is_promotion	String	0
props_name	String	0		商品属性名
property_alias	String	0		商品属性别名
props_list	Mix	0	[]	商品属性列表
seller_id	Bigint	0		卖家ID
shop_id	Bigint	0		店铺ID
seller_info	Mix	0	{"nick": "usauk2008", "city": "", "bail": "", "level": "", "rate": "", "score": "", "delivery_score": "", "item_score": "", "shop_type": "", "user_num_id": "", "sid": "", "title": "", "zhuy": "https://www.ebay.com/usr/usauk2008", "company_name": "", "menu": []}	卖家信息
tmall	Boolean	0		是否天猫
error	String	0		错误信息
warning	String	0		警告信息
url_log	String	0
shopinfo	Mix	0	{"shop_name": ""}	店铺信息
promo_type	String	0
shop_item	Mix	0	[]
relate_items	Mix	0	[]
skus	Mix	0	{"sku": [] }
props	Mix	0	[{"name": "以前使用过或磨损过的物品。有关任何缺陷的详细信息和描述，请参见卖方清单。在新窗口或选项卡中查看所有条件定义", "value": "&“状况非常好，没有问题”"}]
currency_code	String	0	USD	当前货币代码
currency_lang	String	0	en	当前语言

请求示例

响应示例

异常示例

相关资料

错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否

API 工具

易贝（eBay）是一个在线拍卖和购物网站，提供了一个API（应用程序接口）供开发者获取商品详情等信息。使用eBay的API，你可以编写应用程序来查询商品、检索拍卖详情、跟踪订单等。

当你调用eBay的API获取商品详情时，通常会返回一个JSON或XML格式的响应，这个响应包含了商品的详细信息。以下是一个简化的JSON格式的eBay商品详情API返回值示例及说明：

```json
{
  "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等
  }
}
```

返回值说明：

- `ack`: API调用的响应状态，通常是"Success"表示成功，"Failure"表示失败。
- `version`: API的版本号。
- `timestamp`: 请求处理的时间戳。
- `build`: eBay系统的构建版本号。
- `Item`: 商品信息对象。
  - `ItemID`: 商品的唯一ID。
  - `Title`: 商品标题。
  - `PrimaryCategory`: 商品的主要分类信息。
    - `CategoryID`: 分类ID。
    - `CategoryName`: 分类名称。
  - `StartPrice`: 商品的起始价格。
    - `currencyID`: 货币类型，如USD。
    - `__value__`: 价格值。
  - `CurrentPrice`: 商品的当前价格（对于固定价格商品或当前竞拍价格）。
  - `HighBidder`: 当前最高出价者的信息。
    - `UserID`: 出价者ID。
    - `UserName`: 出价者用户名。
  - `QuantitySold`: 已售出的商品数量。
  - `ListingInfo`: 列表信息。
    - `ListingDuration`: 列表持续时间，如GTC（Good Until Canceled，直到取消为止）。
    - `ListingType`: 列表类型，如FixedPriceItem（固定价格商品）。
    - `BestOfferEnabled`: 是否启用“最佳报价”功能。
  - `PaymentMethods`: 支付方式，如PayPal。
  - `ShippingInfo`: 运输信息。
    - `ShippingServiceCost`: 运输服务费用。
    - `ShipToLocations`: 可发货地点。
    - `ExpeditedShipping`: 是否提供加急运输。
  - `PictureURL`: 商品的图片URL。
  - `ViewItemURLForNaturalSearch`: 商品的自然搜索URL。
  - `Description`: 商品的描述。
  - `Seller`: 卖家信息。
    - `UserID`: 卖家ID。
    - `UserName`: 卖家用户名。

请注意，实际的API返回值可能会比这个示例更加复杂，是的，我之前的示例只是一个简化的、概念性的返回值结构。在实际使用中，EBAY商品详情API的返回值可能会包含更多的字段和嵌套结构，具体取决于你请求的商品和API的版本。

以下是一些可能存在的额外字段和结构的例子：

```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": [
      // 如果商品有多个变体，这里会列出每个变体的信息
    ],
    "SKU": "LAPTOP-001",
    "MPN": "LNX-MNXB2",
    "Brand":