製造商檢索

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

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