taobao.sellercats.list.get
获取自定义商品类目

基础 需要授权 用户授权介绍 收费 查看API收费规则

请求地址

环境 HTTP地址 HTTPS地址 请求方式
正式环境 http://open.ieasynote.com/api https://open.ieasynote.com/api POST

公共参数

参数名 类型 必须 描述
method String API接口名称,例如:taobao.sellercats.list.get
app_key String TOP分配给应用的AppKey,例如:12345678
session String 用户登录授权成功后,TOP颁发给应用的授权信息,详细介绍请[点击这里]()。当此API的标签上注明:“需要授权”,则此参数必传;“不需要授权”,则此参数不需要传;“可选授权”,则此参数为可选
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟
v String API协议版本,可选值:2.0
sign_method String 签名的摘要算法,可选值为:hmac,md5,hmac-sha256
sign String API输入参数签名结果,签名算法介绍请[点击这里](
format String 响应格式。默认为xml格式,可选值:xml,json
simplify Boolean 是否采用精简JSON返回格式,仅当format=json时有效,默认值为:false

公共响应参数

公共响应参数中,error_responsexxx_response只会出现一个
参数名 类型 描述
request_id String 平台颁发的每次请求访问的唯一标识
error_response String 请求访问失败时返回的根节点,和 xxxxx_response 只会出现一个
        code String 请求失败返回的错误码,error_response 的子节点
        msg String 请求失败返回的错误信息,error_response 的子节点
        sub_code String 请求失败返回的子错误码,error_response 的子节点
        sub_msg String 请求失败返回的子错误信息,error_response 的子节点
xxxxx_response String 请求成功返回的根节点, 和 error_response 只会出现一个,'xxxxx' 为API名称的下划线模式,本接口为:sellercats_list_get_response

请求参数

参数名 类型 必须 示例值 描述
没有请求参数

请求响应参数

请求响应参数是 xxx_response 的子节点
参数名 类型 示例值 描述
seller_cats SellerCat [] 卖家自定义类目
  -cid Number 12345 卖家自定义类目编号
  -parent_cid Number 12 父类目编号,值等于0:表示此类目为店铺下的一级类目,值不等于0:表示此类目有父类目
  -name String 自定义类型名称 卖家自定义类目名称
  -pic_url String xva1sdfxxx.jpg 链接图片地址
  -sort_order Number 1 该类目在页面上的排序位置
  -type String manual_type 店铺类目类型:可选值:manual_type:手动分类,new_type:新品上价, tree_type:二三级类目树 ,property_type:属性叶子类目树, brand_type:品牌推广

请求示例代码

将接口地址URL设置成: http://open.ieasynote.com/api
                        
                        
$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new SellercatsListGetRequest;
$req->setFields("cid,name");
$resp = $c->execute($req, $sessionKey);
                                
                    
                        
                        
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SellercatsListGetRequest req = new SellercatsListGetRequest();
req.setFields("cid,name");
SellercatsListGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
                                
                    
                        
                        
ITopClient client = new DefaultTopClient(url, appkey, secret);
SellercatsListGetRequest req = new SellercatsListGetRequest();
req.Fields = "cid,name";
SellercatsListGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);
                                
                    
                        
                        
# -*- coding: utf-8 -*-
import top.api

req=top.api.SellercatsListGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.fields="cid,name"
try:
    resp= req.getResponse(sessionkey)
    print(resp)
except Exception,e:
    print(e)
                                
                    
                        
                        
curl -X POST 'http://open.ieasynote.com/api' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.sellercats.list.get' \
-d 'partner_id=apidoc' \
-d 'session=b8a1ea6a-b80a-4157-b4a5-c9023762422f' \
-d 'sign=DFB4F64A559BFAF2E47A2D464ADE3B1A' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-08-24+14%3A16%3A27' \
-d 'v=2.0' \
-d 'fields=cid%2Cname'
                                
                    
                        
                        
# -*- coding: utf-8 -*-
import top.api

req=top.api.SellercatsListGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.fields='cid,name'
try:
    resp= req.getResponse(sessionkey)
    print(resp)
except Exception,e:
    print(e)
                                
                    
                        
                        
package main;

import (
    "fmt"
    "topsdk"
    "topsdk/defaultability"
    "topsdk/defaultability/request"
)

func main() {
    client := topsdk.NewDefaultTopClient("<your-appkey>","<your-appsecret>","<top-gateway-url>",20000,20000)
    ability := defaultability.NewDefaultability(&client)


    req := request.TaobaoSellercatsListGetRequest{}
    /*
        cid,name
    */
    req.SetFields([]string{})


    resp, err := ability.TaobaoSellercatsListGet(&req, "<user-session>")
    if(err != nil) {
        fmt.Println(err)
    } else {
        fmt.Println(resp.Body)
    }
}
                                
                    
                        
                        
<?php
require "../vendor/autoload.php";
use Topsdk\Topapi\TopApiClient;
use Topsdk\Topapi\Defaultability\Request\TaobaoSellercatsListGetRequest;
use Topsdk\Topapi\Defaultability\Defaultability;


// create Client
$client = new TopApiClient("<your-appkey>","<your-appsecret>","<top-gateway-url>");
$ability = new Defaultability($client);

// create domain

// create request
$request = new TaobaoSellercatsListGetRequest();
/*
    cid,name
*/
$request->setFields(array());

$response = $ability->taobaoSellercatsListGet($request,"<user session>");
var_dump($response);
                                
                    
                        
                        
import com.alibaba.fastjson.JSON;
import java.io.File;
import java.util.ArrayList;
import java.util.Date;
import com.taobao.top.TopApiClient;
import com.taobao.top.DefaultTopApiClient;
import com.taobao.top.TopFileItem;
import com.taobao.top.defaultability.Defaultability;
import com.taobao.top.defaultability.request.TaobaoSellercatsListGetRequest;
import com.taobao.top.defaultability.response.TaobaoSellercatsListGetResponse;

public class Main {

    public static void main(String[] args) throws Exception {
        // create Client
        TopApiClient client = new DefaultTopApiClient("<your-appkey>","<your-appsecret>","<top-gateway-url>");
        Defaultability apiPackage = new Defaultability(client);
        // create domain

        // create request
        TaobaoSellercatsListGetRequest request = new TaobaoSellercatsListGetRequest();
        /*
            cid,name
        */
        request.setFields(new ArrayList<String>());

        TaobaoSellercatsListGetResponse response = apiPackage.taobaoSellercatsListGet(request,"user session");
        if(!response.isSuccess()){
            System.out.println(response.getSubMsg());
        }
        System.out.println(JSON.toJSONString(response));
    }
}
                                
                    

响应示例

                        
                        
<sellercats_list_get_response>
    <seller_cats>
        <seller_cat>
            <cid>12345</cid>
            <parent_cid>12</parent_cid>
            <name>自定义类型名称</name>
            <pic_url>xva1sdfxxx.jpg</pic_url>
            <sort_order>1</sort_order>
            <type>manual_type</type>
        </seller_cat>
    </seller_cats>
</sellercats_list_get_response>
                                
                    
                        
                        
<sellercats_list_get_response>
    <seller_cats>
        <seller_cat>
            <cid>12345</cid>
            <parent_cid>12</parent_cid>
            <name>自定义类型名称</name>
            <pic_url>xva1sdfxxx.jpg</pic_url>
            <sort_order>1</sort_order>
            <type>manual_type</type>
        </seller_cat>
    </seller_cats>
</sellercats_list_get_response>
                                
                    

异常响应示例

                        
                            
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>参数异常</sub_msg>
</error_response>
                            
                    
                        
                            
{
    "error_response":{
        "msg":"Remote service error",
        "code":50,
        "sub_msg":"XXX",
        "sub_code":"isv.invalid-parameter"
    }
}
                            
                    

错误码描述

错误码 错误消息 解决方案
暂无错误解释