制造商检索

查询新蛋系统可用制造商列表。

相关URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo?sellerid={sellerid}
NeweggBusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/manufacturer/manufacturerinfo?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/manufacturer/manufacturerinfo?sellerid={sellerid}

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号

相关请求信息

HTTP方式 是否需要认证 请求格式 回复格式 频率限制
PUT 需要 XML,Json XML,Json 1000 请求/小时

请求文件主体

属性 是否必填？ 格式 描述
OperationType 是 String 固定值：GetManufacturerReqeust
PageIndex 否 Integer 当前页索引

如果为空，默认使用1
PageSize 否 Integer 一页返回记录个数（最大值为每页100条记录）

如果为空，默认使用100
CreateDateFrom 否 String 筛选在该指定日期之后创建的制造商名称，请参考可接受的日期格式
CreateDateTo 否 String 筛选在该指定日期之前创建的制造商名称，请参考可接受的日期格式
ManufactureName 否 String 制造商名称

如果为空，将返回所有制造商名称

Schema: GetManufacturerRequest.xsd

示例：XML，Request

PUT https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest >
    <OperationType>GetManufacturerRequest</OperationType>
    <RequestBody>
        <PageIndex>1</PageIndex>
        <PageSize>10</PageSize>
        <RequestCriteria>
            <CreatedDateFrom>2013-08-30 14:20:00</CreatedDateFrom>
            <CreatedDateTo>2013-08-30 18:20:00</CreatedDateTo>
            <ManufacturerName>
                <![CDATA[sony & wonder]]>
            </ManufacturerName>
        </RequestCriteria>
    </RequestBody>
</NeweggAPIRequest>

示例：Json，Request

PUT https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "GetManufacturerRequest",
    "RequestBody": {
      "PageIndex": "1",
      "PageSize": "10",
      "RequestCriteria": {
        "CreatedDateFrom": "2013-08-30 14:20:00",
        "CreatedDateTo": "2013-08-30 18:20:00",
        "ManufacturerName": "sony & wonder"
      }
    }
}

回复文件主题

属性 格式 描述
IsSuccess String 用于确认制造商检索是否成功

固定值：True
SellerID String 您的商家编号
OperationType String 固定值：GetManufacturerResponse
ResponseDate String 回复日期
Memo String 附加信息
TotalCount Integer 记录总数
TotalPageCount Integer 总页数
PageIndex Integer 当前页索引
PageSize Integer 一页中的记录数
Name String 制造商名称
IsRestricted Integer 制造商是否受限：

  • 0：否
  • 1：是
SubcategoryID Integer 受限制造商的受限子类目编号

如果制造商所有子类目都受限，该值为空
SubcategoryName String 受限制造商的受限子类目名称

如果制造商所有子类目都受限，该值为空
MappedName String 被映射的制造商名称。 如果您使用的制造商在新蛋系统中已存在，当创建一个新的商品，新蛋会使用映射的方式创建。
例如： 被映射的制造商名称：SONY
映射名称： Sony Ericsson Mobile，Sony Audio/Video，Sony PlayStation，Sony Creative Software，Sony Creative Software, Inc
如果您使用任何一个映射名称来创建一个新的项目，制造商将统一使用SONY。

Schema: GetManufacturerResponse.xsd

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
  <IsSuccess>true</IsSuccess>
  <SellerID>A006</SellerID>
  <OperationType>GetManufacturerResponse</OperationType>
  <ResponseDate>2/22/2012 16:51:03</ResponseDate>
  <Memo />
  <ResponseBody>
    <PageInfo>
      <TotalCount>1</TotalCount>
      <TotalPageCount>1</TotalPageCount>
      <PageSize>10</PageSize>
      <PageIndex>1</PageIndex>
    </PageInfo>
    <ManufacturerList>
      <Manufacturer>
        <Name><![CDATA[sony & wonder]]></Name>
        <IsRestricted>0</IsRestricted>
        <RestrictedSubcategoryList/>
        <MappedNameList>
          <MappedName>wonder</MappedName>
        </MappedNameList>
      </Manufacturer>
      <Manufacturer>
        <Name><![CDATA[newegg]]></Name>
        <IsRestricted>1</IsRestricted>
        <RestrictedSubcategoryList>
          <Subcategory>
            <SubcategoryID>1508</SubcategoryID>
            <SubcategoryName><![CDATA[Belts & Suspenders]]></SubcategoryName>
          </Subcategory>
          <Subcategory>
            <SubcategoryID>153</SubcategoryID>
            <SubcategoryName><![CDATA[Buckles]]></SubcategoryName>
          </Subcategory>
        </RestrictedSubcategoryList>
         <MappedNameList>
          <MappedName>test_newegg</MappedName>
        </MappedNameList>
      </Manufacturer>
    </ManufacturerList>
  </ResponseBody>
  </NeweggAPIResponse>

示例：Json，Response

{
    "IsSuccess": "true",
    "SellerID": "A006",
    "OperationType": "GetManufacturerResponse",
    "ResponseDate": "2/22/2012 16:51:03",
    "ResponseBody": {
        "PageInfo": {
            "TotalCount": "1",
            "TotalPageCount": "1",
            "PageSize": "10",
            "PageIndex": "1"
        },
        "ManufacturerList": {
            "Manufacturer": [
                {
                    "Name": "sony & wonder",
                    "IsRestricted": "0",
                    "MappedNameList": {
                        "MappedName": "wonder"
                    }
                },
                {
                    "Name": "newegg",
                    "IsRestricted": "1",
                    "RestrictedSubcategoryList": {
                        "Subcategory": [
                            {
                                "SubcategoryID": "1508",
                                "SubcategoryName": "Belts & Suspenders"
                            },
                            {
                                "SubcategoryID": "153",
                                "SubcategoryName": "Buckles"
                            }
                        ]
                    },
                    "MappedNameList": {
                        "MappedName": "test_newegg"
                    }
                }
            ]
        }
    }
}

请求失败错误信息

常规HTTP错误回复，请参考回复失败错误代码列表。

错误代码 描述
CT033 Invalid manufacturer name :{0}

无效的制造商名称: {0}

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CT033</Code>
        <Message>Invalid manufacturer name: Joe Machine</Message>
    </Error>
</Errors>

示例：Json，Response

[
    {
        "Code": "CT033",
        "Message": "Invalid manufacturer name: Joe Machine"
    }
]

更新日期：10/15/2018