获取商品检索报告
请求获取新蛋类目下有效商品列表。
相关URL
Newegg.com: https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid} Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/reportmgmt/report/result?sellerid={sellerid} Newegg.ca: https://api.newegg.com/marketplace/can/reportmgmt/report/result?sellerid={sellerid}
注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。
参数
名称 | 是否必填? | 描述 |
sellerid | 是 | 您在新蛋商城的商家编号 |
相关请求信息
HTTP方式 | 是否需要认证? | 请求格式 | 回复格式 | 频率限制 |
PUT | 需要 | XML,Json | XML,Json | 500 请求/小时 |
请求文件主体
属性 | 是否必填? | 格式 | 描述 |
IssueUser | 否 | String | 请求发送者在Seller Portal上注册过的邮箱地址 。
系统只接受商家注册过的Seller Portal邮箱地址。如果为空,默认值为商家编号 |
OperationType | 是 | String | 固定值:ItemLookupRequest |
RequestID | 是 | String | 新蛋分配的已提交的请求的编号 |
PageIndex | 是 | Integer | 当前页索引 |
PageSize | 是 | Integer | 一页返回的记录总数
每页最多100条。 |
Schema: GetReportRequest.xsd
示例:XML,Request
PUT https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/xml Accept: application/xml <NeweggAPIRequest > <OperationType>ItemLookupRequest</OperationType> <RequestBody> <RequestID>2PQBYWH4V68ZP</RequestID> <PageInfo> <PageIndex>1</PageIndex> <PageSize>10</PageSize> </PageInfo> </RequestBody> </NeweggAPIRequest>
示例:Json,Request
PUT https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/json Accept: application/json { "OperationType": "ItemLookupRequest", "RequestBody": { "RequestID": "2PQBYWH4V68ZP", "PageInfo": { "PageSize": "10", "PageIndex": "1" } } }
回复文件主体
属性 | 格式 | 描述 |
IsSuccess | String | 获取数据状态的操作: True: 成功 False: 失败 |
SellerID | String | 您的商家编号 |
OperationType | String | 固定值:ItemLookupResponse |
RequestID | String | 已提交的请求编号 |
RequestDate | String | 请求提交时间(太平洋标准时间) |
TotalCount | Integer | 总记录数 |
TotalPageCount | Integer | 总页数 |
PageIndex | Integer | 当前页索引 |
PageSize | Integer | 一页的记录个数 |
SellerID | String | 您的商家编号 |
NeweggItemNumber | String | 新蛋商品编号 |
UPC | String | UPC 编码 |
Condition | String | 有效值: 1. New 全新的 2. Refurbished 翻新的 3. Used – Like New 二手-类似新品 4. Used – Very Good 二手-非常好 5. Used – Good 二手-好 6. Used – Acceptable 二手-尚可 注:二手Used只适用于Newegg.com |
PacksOrSets | Integer | 定义该商品的封装数量 注:所有封装商品都会有匹配的商品和状态 |
ManufacturerName | Integer | 制造商名称 |
ManufacturerPartNumber | String | 制造商商品编号 |
WebsiteShortTitle | String | 商品短标题 |
Note | String | 请求的错误信息(例如:未找到匹配记录) |
ResponseDate | String | 回复日期(太平洋标准时间) |
Schema: ItemLookupResponse.xsd
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?> <NeweggAPIResponse> <IsSuccess>true</IsSuccess> <OperationType>ItemLookupResponse</OperationType> <SellerID>bfwk</SellerID> <ResponseBody> <PageInfo> <TotalCount>4</TotalCount> <TotalPageCount>1</TotalPageCount> <PageIndex>1</PageIndex> <PageSize>10</PageSize> </PageInfo> <RequestID>28292T8ASAL64</RequestID> <RequestDate>07/11/2014 18:14:04</RequestDate> <ItemList> <Item> <ParentItemNumber>01T-001Y-00004</ParentItemNumber> <UPC>20140711101111</UPC> <Condition>1</Condition> <PacksOrSets>1</PacksOrSets> <ManufacturerName> <![CDATA[q-see ]]> </ManufacturerName> <ManufacturerPartNumber> <![CDATA[canmfpn20140711101 ]]> </ManufacturerPartNumber> <WebShortTitle> <![CDATA[b2b new item 201407111001 ]]> </WebShortTitle> </Item> <Item> <ParentItemNumber>01T-001Y-00004</ParentItemNumber> <UPC>20140711101111</UPC> <Condition>1</Condition> <PacksOrSets>1</PacksOrSets> <ManufacturerName> <![CDATA[q-see ]]> </ManufacturerName> <ManufacturerPartNumber> <![CDATA[canmfpn20140711101 ]]> </ManufacturerPartNumber> <WebShortTitle> <![CDATA[b2b new item 201407111001 ]]> </WebShortTitle> </Item> <Item> <ParentItemNumber>01T-001Y-00004</ParentItemNumber> <UPC>20140711101111</UPC> <Condition>1</Condition> <PacksOrSets>1</PacksOrSets> <ManufacturerName> <![CDATA[q-see ]]> </ManufacturerName> <ManufacturerPartNumber> <![CDATA[canmfpn20140711101 ]]> </ManufacturerPartNumber> <WebShortTitle> <![CDATA[b2b new item 201407111001 ]]> </WebShortTitle> </Item> <Item> <ParentItemNumber>01T-001Y-00007</ParentItemNumber> <UPC /> <Condition>2</Condition> <PacksOrSets>1</PacksOrSets> <ManufacturerName> <![CDATA[q-see ]]> </ManufacturerName> <ManufacturerPartNumber> <![CDATA[canmfpn20140711101 ]]> </ManufacturerPartNumber> <WebShortTitle> <![CDATA[456346 ]]> </WebShortTitle> </Item> </ItemList> </ResponseBody> <ResponseDate>07/11/2014 19:00:59</ResponseDate> </NeweggAPIResponse>
示例:Json,Response
{ "NeweggAPIResponse": { "IsSuccess": "true", "OperationType": "ItemLookupResponse", "SellerID": "bfwk", "ResponseBody": { "PageInfo": { "TotalCount": "4", "TotalPageCount": "1", "PageIndex": "1", "PageSize": "10" }, "RequestID": "28292T8ASAL64", "RequestDate": "07/11/2014 18:14:04", "ItemList": { "Item": [ { "ParentItemNumber": "01T-001Y-00004", "UPC": "20140711101111", "Condition": "1", "PacksOrSets": "1", "ManufacturerName": "q-see", "ManufacturerPartNumber": "canmfpn20140711101", "WebShortTitle": "b2b new item 201407111001" }, { "ParentItemNumber": "01T-001Y-00004", "UPC": "20140711101111", "Condition": "1", "PacksOrSets": "1", "ManufacturerName": "q-see", "ManufacturerPartNumber": "canmfpn20140711101", "WebShortTitle": "b2b new item 201407111001" }, { "ParentItemNumber": "01T-001Y-00004", "UPC": "20140711101111", "Condition": "1", "PacksOrSets": "1", "ManufacturerName": "q-see", "ManufacturerPartNumber": "canmfpn20140711101", "WebShortTitle": "b2b new item 201407111001" }, { "ParentItemNumber": "01T-001Y-00007", "UPC": "", "Condition": "2", "PacksOrSets": "1", "ManufacturerName": "q-see", "ManufacturerPartNumber": "canmfpn20140711101", "WebShortTitle": "456346" } ] } }, "ResponseDate": "07/11/2014 19:00:59" } }
请求失败错误信息
常规HTTP错误回复,请参考回复失败错误代码列表。
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?> <Errors> <Error> <Code>CE001</Code> <Message>SellerID cannot be null or empty</Message> </Error> </Errors>
示例:Json,Response
[ { "Code": "CE001", "Message": "SellerID cannot be null or empty" } ]
更新日期:10/15/2018