ezbuy.category.get (获取商品发布类目)

GET

获取卖家发布商品所需要的标准类目

公共参数

名称 类型 是否必须 描述
method string y api接口名称
app_key string y ezbuy分配给应用的AppKey
sign_method string y 签名摘要算法,可选值:hmac,md5
sign string y api输入参数的签名结果
timestamp string y 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8。ezbuy api服务端允许客户端请求的最大时间误差为10分钟
version string y api协议版本,可选值:1.0

请求参数

名称 类型 是否必须 示例值 限制 描述
parent_cid number y 782342 父级类目id, 传0则返回所有一级类目;

响应参数

名称 类型 示例值 描述
request_id string 92128f6e-daf3-11e7-a003-f45c89aebcfb 请求id
status RespCode 接口响应状态
data Category[] 类目信息

响应示例

{
    "request_id":"92128f6e-daf3-11e7-a003-f45c89aebcfb",
    "status": {
        "code": "E0",
        "message": "success"
    },
    "data": [
        {
            "cid": 81,
            "name": "女装"
        },
        {
            "cid": 1,
            "name": "服饰配件"
        },
        {
            "cid": 35,
            "name": "男装"
        },
        {
            "cid": 146,
            "name": "孕婴童"
        },
        {
            "cid": 358,
            "name": "鞋"
        },
        {
            "cid": 380,
            "name": "珠宝"
        },
        {
            "cid": 401,
            "name": "手表"
        },
        {
            "cid": 412,
            "name": "玩具"
        },
        {
            "cid": 502,
            "name": "运动及娱乐"
        },
        {
            "cid": 860,
            "name": "办公文教用品"
        },
        {
            "cid": 1042,
            "name": "家具"
        },
        {
            "cid": 1335,
            "name": "家居用品"
        },
        {
            "cid": 1842,
            "name": "家用电器"
        },
        {
            "cid": 2014,
            "name": "婚礼及重要场合"
        },
        {
            "cid": 2043,
            "name": "美容健康"
        },
        {
            "cid": 2308,
            "name": "手机&通讯"
        },
        {
            "cid": 2317,
            "name": "箱包"
        },
        {
            "cid": 2353,
            "name": "汽车 & 摩托"
        },
        {
            "cid": 2787,
            "name": "鞋配饰"
        },
        {
            "cid": 2864,
            "name": "消费电子品"
        },
        {
            "cid": 3151,
            "name": "硬装 & 材料"
        },
        {
            "cid": 4485,
            "name": "五金/工具"
        },
        {
            "cid": 5131,
            "name": "电脑&周边"
        },
        {
            "cid": 5188,
            "name": "电子/电工"
        },
        {
            "cid": 7181,
            "name": "童装/婴儿装及配饰"
        },
        {
            "cid": 7278,
            "name": "童鞋/婴儿鞋/亲子鞋"
        },
        {
            "cid": 7303,
            "name": "食品类"
        },
        {
            "cid": 7365,
            "name": "sunglasses"
        }
    ]
}

异常示例

{
    "request_id":"92128f6e-daf3-11e7-a003-f45c89aebcfb",
    "status": {
        "code": "E81",
        "message": "invalid parent_cid",
        "detail": "123415 is not a valid cid"
    }
}

错误码

CODE MESSAGE DETAIL
E81 invalid parent_cid {parent_cid} is not a valid cid

ezbuy.category.props.get (获取类目属性)

GET

获取发布类目下的属性列表

公共参数

名称 类型 是否必须 描述
method string y api接口名称
app_key string y ezbuy分配给应用的AppKey
sign_method string y 签名摘要算法,可选值:hmac,md5
sign string y api输入参数的签名结果
timestamp string y 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8。ezbuy api服务端允许客户端请求的最大时间误差为10分钟
version string y api协议版本,可选值:1.0

请求参数

名称 类型 是否必须 示例值 限制 描述
cid number y 782342 类目属性id

响应参数

名称 类型 示例值 描述
request_id string 92128f6e-daf3-11e7-a003-f45c89aebcfb 本次api调用对应的请求id
status RespCode 接口响应状态
data CategoryProp[] 类目属性

响应示例

{
    "request_id":"92128f6e-daf3-11e7-a003-f45c89aebcfb",
    "status": {
        "code": "E0",
        "message": "success"
    },
    "data": [
        {
            "pid": 85134,
            "name": "连接器颜色"
        },
        {
            "pid": 122535,
            "name": "颜色",
            "type": 1,
            "values": [
                {
                    "vid": 54658,
                    "name": "荧光"
                },
                {
                    "vid": 46599,
                    "name": "茶"
                },
                {
                    "vid": 85485,
                    "name": "豹纹"
                },
                {
                    "vid": 123013,
                    "name": "奶油白"
                },
                {
                    "vid": 46590,
                    "name": "金"
                },
                {
                    "vid": 123010,
                    "name": "军绿"
                },
                {
                    "vid": 123008,
                    "name": "枚红色"
                },
                {
                    "vid": 123006,
                    "name": "荧光黄"
                },
                {
                    "vid": 123004,
                    "name": "草绿色"
                },
                {
                    "vid": 123002,
                    "name": "枪黑色"
                }
            ]
        }
    ]
}

异常示例

{
    "request_id":"92128f6e-daf3-11e7-a003-f45c89aebcfb",
    "status": {
        "code": "E56",
        "message": "invalid cid",
        "detail": "123415 is not a valid cid"
    }
}

错误码

CODE MESSAGE DETAIL
E56 invalid cid {cid} is not a valid cid