製造商檢索

查詢新蛋系統可用製造商清單。

相關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