获取子类目属性值

获取指定子类目下的属性值。

相关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,Response

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,Request

<?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,Request

<?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