獲取子類目狀態

獲取指定商家帳戶下的子類目狀態。子類目對該商家是否開放。

相關URL

Newegg.com: https://api.newegg.com/marketplace/sellermgmt/seller/subcategory?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/sellermgmt/seller/subcategory?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/sellermgmt/seller/subcategory?sellerid={sellerid}

註：請確保您的請求URL全都是小寫（除Seller ID）並且不能包含任何空格或者分行符號。

參數

名稱 是否必填？ 描述
sellerid 是 您在新蛋商城的商家編號

相關請求資訊

HTTP方式 是否需要認證？ 請求格式 回復格式 頻率限制
PUT 需要 XML,Json XML,Json 100 請求/小時

請求文件主體

屬性 是否必填？ 格式 描述
OperationType 是 String 固定值：GetSellerSubcategoryRequest
SubcategoryID 否 Integer 子類目編號
若填寫了該欄位，那麼回覆中只包含指定子類目編號的資訊。
IndustryCode 否 String 主類目代碼
Enabled 否 Integer 由子類當前狀態作為條件來過濾當前的請求。
0 – Not Enabled 未開放的
1 – Enabled 開放的
若為空，回覆將返回已開放和未開放子類目

Schema:  GetSubcatetoryRequest.xsd

示例：XML, Request

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

<NeweggAPIRequest>
    <OperationType>GetSellerSubcategoryRequest</OperationType>
    <RequestBody>
        <GetItemSubcategory>
            <SubcategoryIDList>
                <SubcategoryID>397</SubcategoryID>
            </SubcategoryIDList>
            <IndustryCodeList>
                <IndustryCode>CH</IndustryCode>
            </IndustryCodeList>
            <Enabled>1</Enabled>
        </GetItemSubcategory>
    </RequestBody>
</NeweggAPIRequest>

示例：Json, Request

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

{
    "OperationType": "GetSellerSubcategoryRequest",
    "RequestBody": {
        "GetItemSubcategory": {
            "SubcategoryIDList": {
                "SubcategoryID": "397"
            },
            "IndustryCodeList": {
                "IndustryCode": "CH"
            },
            "Enabled": "1"
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 用於獲取資料狀態的操作
True：成功
False：失敗
OperationType String 固定值：GetSellerSubcategoryResponse
SellerID String 您的商家編號
IndustryCode String 新蛋主類目編碼
IndustryName String 新蛋主類目名稱
SubcategoryID Integer 子類目編號
SubcategoryName String 子類目名稱
Enabled Integer 子類目對此商家是否是開放
有效值：
0 – Not Enabled  未開放的
1 – Enabled  開放的

Schema: GetSubcatetoryResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetSellerSubcategoryResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <SubcategoryList>
            <Subcategory>
                <IndustryCode>AP</IndustryCode>
                <IndustryName>Apparel</IndustryName>
                <SubcategoryID>1508</SubcategoryID>
                <SubcategoryName>
                    <![CDATA[Belts & Suspenders]]>
                </SubcategoryName>
                <Enabled>1</Enabled>
            </Subcategory>
            <Subcategory>
                <IndustryCode>AP</IndustryCode>
                <IndustryName>Apparel</IndustryName>
                <SubcategoryID>153</SubcategoryID>
                <SubcategoryName>
                    <![CDATA[Buckles]]>
                </SubcategoryName>
                <Enabled>0</Enabled>
            </Subcategory>
        </SubcategoryList>
    </ResponseBody>
</NeweggAPIResponse>

示例: Json, Response

{
    "IsSuccess": "true",
    "OperationType": "GetSellerSubcategoryResponse",
    "SellerID": "A006",
    "ResponseBody": {
        "SubcategoryList": [
            {
                "IndustryCode": "AP",
                "IndustryName": "Apparel",
                "SubcategoryID": "1508",
                "SubcategoryName": "Belts & Suspenders",
                "Enabled": "1"
            },
            {
                "IndustryCode": "AP",
                "IndustryName": "Apparel",
                "SubcategoryID": "153",
                "SubcategoryName": "Buckles",
                "Enabled": "0"
            }
        ]
    }
}

請求失敗錯誤資訊

常規HTTP錯誤回應，請參考回覆失敗錯誤代碼清單。

錯誤代碼 描述
DF008 Invalid industry code [{0}].

無效的主類目編碼[{0}].

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>DF008</Code>
        <Message>Invalid industry code ABC</Message>
    </Error>
</Errors>

示例: Json, Response

[
    {
        "Code": "DF008",
        "Message": "Invalid industry code ABC"
    }
]

更新日期：10/15/2018