獲取子類目屬性值

獲取指定子類目下的屬性值。

相關URL

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

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

參數

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

相關請求資訊

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

請求文件主體

屬性 是否必填? 格式 描述
OperationType String 固定值:GetSellerPropertyValueRequest
SubcategoryID Integer 新蛋子類目編號
註:

  • 使用獲取子類目狀態請求獲取
  • 如果不填,返回所有已開放的子類的屬性資訊。
PropertyName String 新蛋屬性名稱
註:使用獲取子類目屬性清單請求獲取

Schema: GetSubcategoryPropertyValueRequest.xsd

示例:XML, Request

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

<NeweggAPIRequest>
    <OperationType>GetSellerPropertyValueRequest</OperationType>
    <RequestBody>
        <SubcategoryID>1045</SubcategoryID>
        <PropertyName>Costume_Gender</PropertyName>
    </RequestBody>
</NeweggAPIRequest>

示例:Json, Request

PUT https://api.newegg.com/marketplace/sellermgmt/seller/propertyvalue?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
    "OperationType": "GetSellerPropertyValueRequest",
    "RequestBody": {
        "SubcategoryID": "1045",
        "PropertyName": "Costume_Gender"
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 用於獲取資料狀態的操作
True:成功
False:失敗
OperationType String 固定值:GetSellerPropertyValueResponse
SellerID String 您的商家編號
SubcategoryID Integer 子類目編號
SubcategoryName String 子類目名稱
PropertyName String 指定新蛋子類目的屬性名
IsAdvancedSearch Integer 在 Newegg 網站上所提供的高級搜索導航中是否顯示該屬性
有效值:
0 – No 否
1 – Yes 是
IsGroupBy Integer 是否為 Group-by 屬性
有效值:
0 – No 否
1 – Yes 是
IsRequired Integer 是否是必填屬性
有效值:
0 – No 否
1 – Yes 是
PropertyValue String 屬性值

Schema: GetSubcategoryPropertyValueResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetSellerPropertyValueResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <PropertyInfoList>
            <PropertyInfo>
                <SubcategoryID>1045</SubcategoryID>
                <SubcategoryName>
                    <![CDATA[Costume]]>
                </SubcategoryName>
                <PropertyName>
                    <![CDATA[Costume_Gender]]>
                </PropertyName>
                <IsAdvancedSearch>1</IsAdvancedSearch>
                <IsGroupBy>0</IsGroupBy>
                <IsRequired>0</IsRequired>
                <PropertyValueList>
                    <PropertyValue>
                        <![CDATA[Male]]>
                    </PropertyValue>
                </PropertyValueList>
            </PropertyInfo>
            <PropertyInfo>
                <SubcategoryID>1045</SubcategoryID>
                <SubcategoryName>
                    <![CDATA[Costume]]>
                </SubcategoryName>
                <PropertyName>
                    <![CDATA[Costume_Gender]]>
                </PropertyName>
                <IsAdvancedSearch>1</IsAdvancedSearch>
                <IsGroupBy>0</IsGroupBy>
                <IsRequired>0</IsRequired>
                <PropertyValueList>
                    <PropertyValue>
                        <![CDATA[Female]]>
                    </PropertyValue>
                </PropertyValueList>
            </PropertyInfo>
            <PropertyInfo>
                <SubcategoryID>1045</SubcategoryID>
                <SubcategoryName>
                    <![CDATA[Costume]]>
                </SubcategoryName>
                <PropertyName>
                    <![CDATA[Costume_Gender]]>
                </PropertyName>
                <IsAdvancedSearch>1</IsAdvancedSearch>
                <IsGroupBy>0</IsGroupBy>
                <IsRequired>0</IsRequired>
                <PropertyValueList>
                    <PropertyValue>
                        <![CDATA[Unisex]]>
                    </PropertyValue>
                </PropertyValueList>
            </PropertyInfo>
        </PropertyInfoList>
    </ResponseBody>
</NeweggAPIResponse>

示例: Json, Response

{
    "IsSuccess": "true",
    "OperationType": "GetSellerPropertyValueResponse",
    "SellerID": "A006",
    "ResponseBody": {
        "PropertyInfoList": [
            {
                "SubcategoryID": "1045",
                "SubcategoryName": "Costume",
                "PropertyName": "Costume_Gender",
                "IsAdvancedSearch": "1",
                "IsGroupBy": "0",
                "IsRequired": "0",
                "PropertyValueList": [
                    "Male"
                ]
            },
            {
                "SubcategoryID": "1045",
                "SubcategoryName": "Costume",
                "PropertyName": "Costume_Gender",
                "IsAdvancedSearch": "1",
                "IsGroupBy": "0",
                "IsRequired": "0",
                "PropertyValueList": [
                    "Female"
                ]
            },
            {
                "SubcategoryID": "1045",
                "SubcategoryName": "Costume",
                "PropertyName": "Costume_Gender",
                "IsAdvancedSearch": "1",
                "IsGroupBy": "0",
                "IsRequired": "0",
                "PropertyValueList": [
                    "Unisex"
                ]
            }
        ]
    }
}

請求失敗錯誤資訊

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

錯誤代碼 描述
DF009 Invalid subcategory ID [{0}].
無效的子類目編號[{0}]

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>DF009</Code>
        <Message>Invalid subcategory ID ABC</Message>
    </Error>
</Errors>

示例: Json, Response

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

更新日期:10/15/2018