淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

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

名称	类型	是否必须	示例值	更多限制	描述
create_dish_category_op_request	CreateDishCategoryOpRequest	必须			业务请求参数
dish_category_dto_list DishCategoryDto [] 必须分类信息列表 └ category_id String 必须 362168 类别ID └ category_name String 必须类别1 类别名称 └ leaf_flag String 可选 Y 是否叶子节点 Y/N └ parent_id String 可选 592155 父节点（类别ID） └ serving_sort Number 可选 0 上菜次序 └ sort Number 可选 1 排序号 └ merchant_id String 必须 455912 集团机构ID(外部商户) └ org_id String 必须 88122 当前机构ID(外部商户)

名称	类型	示例值	描述
result	CommonResult		接口结果
biz_data_list OutBizNoMappingDto [] 业务数据 └ out_biz_no String G56112 第三方id └ id String 45125156 saas的Id └ biz_id String 业务主键 └ error_code String 5002 业务处理结果（错误码） └ error_desc String 错误1 错误描述 └ success Boolean false 业务处理是否成功

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscDishCategoryCreateRequest req = new AlibabaAlscDishCategoryCreateRequest();
AlibabaAlscDishCategoryCreateRequest.CreateDishCategoryOpRequest obj1 = new AlibabaAlscDishCategoryCreateRequest.CreateDishCategoryOpRequest();
List<AlibabaAlscDishCategoryCreateRequest.DishCategoryDto> list3 = new ArrayList<AlibabaAlscDishCategoryCreateRequest.DishCategoryDto>();
AlibabaAlscDishCategoryCreateRequest.DishCategoryDto obj4 = new AlibabaAlscDishCategoryCreateRequest.DishCategoryDto();
list3.add(obj4);
obj4.setCategoryId("362168");
obj4.setCategoryName("类别1");
obj4.setLeafFlag("Y");
obj4.setParentId("592155");
obj4.setServingSort(0L);
obj4.setSort(1L);
obj1.setDishCategoryDtoList(list3);
obj1.setMerchantId("455912");
obj1.setOrgId("88122");
req.setCreateDishCategoryOpRequest(obj1);
AlibabaAlscDishCategoryCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlscDishCategoryCreateRequest req = new AlibabaAlscDishCategoryCreateRequest();
AlibabaAlscDishCategoryCreateRequest.CreateDishCategoryOpRequestDomain obj1 = new AlibabaAlscDishCategoryCreateRequest.CreateDishCategoryOpRequestDomain();
List<AlibabaAlscDishCategoryCreateRequest.DishCategoryDtoDomain> list3 = new List<AlibabaAlscDishCategoryCreateRequest.DishCategoryDtoDomain>();
AlibabaAlscDishCategoryCreateRequest.DishCategoryDtoDomain obj4 = new AlibabaAlscDishCategoryCreateRequest.DishCategoryDtoDomain();
list3.Add(obj4);
obj4.CategoryId = "362168";
obj4.CategoryName = "类别1";
obj4.LeafFlag = "Y";
obj4.ParentId = "592155";
obj4.ServingSort = 0L;
obj4.Sort = 1L;
obj1.DishCategoryDtoList= list3;
obj1.MerchantId = "455912";
obj1.OrgId = "88122";
req.CreateDishCategoryOpRequest_ = obj1;
AlibabaAlscDishCategoryCreateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlscDishCategoryCreateRequest;
$create_dish_category_op_request = new CreateDishCategoryOpRequest;
$dish_category_dto_list = new DishCategoryDto;
$dish_category_dto_list->category_id="362168";
$dish_category_dto_list->category_name="类别1";
$dish_category_dto_list->leaf_flag="Y";
$dish_category_dto_list->parent_id="592155";
$dish_category_dto_list->serving_sort="0";
$dish_category_dto_list->sort="1";
$create_dish_category_op_request->dish_category_dto_list = $dish_category_dto_list;
$create_dish_category_op_request->merchant_id="455912";
$create_dish_category_op_request->org_id="88122";
$req->setCreateDishCategoryOpRequest(json_encode($create_dish_category_op_request));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.alsc.dish.category.create' \
-d 'partner_id=apidoc' \
-d 'sign=8C6CDBB97DB49CCB6066B94D81CEBE57' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+07%3A07%3A09' \
-d 'v=2.0' \
-d 'create_dish_category_op_request=null'

# -*- coding: utf-8 -*-
import top.api

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

req.create_dish_category_op_request=""
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.alsc.dish.category.create");
add_param(pRequest,"create_dish_category_op_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.alsc.dish.category.create', {
	'create_dish_category_op_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alsc_dish_category_create_response>
    <result>
        <biz_data_list>
            <out_biz_no_mapping_dto>
                <out_biz_no>G56112</out_biz_no>
                <id>45125156</id>
            </out_biz_no_mapping_dto>
        </biz_data_list>
        <biz_id></biz_id>
        <error_code>5002</error_code>
        <error_desc>错误1</error_desc>
        <success>false</success>
    </result>
</alibaba_alsc_dish_category_create_response>

{
    "alibaba_alsc_dish_category_create_response":{
        "result":{
            "biz_data_list":{
                "out_biz_no_mapping_dto":[
                    {
                        "out_biz_no":"G56112",
                        "id":"45125156"
                    }
                ]
            },
            "biz_id":"",
            "error_code":"5002",
            "error_desc":"错误1",
            "success":false
        }
    }
}

XML示例
JSON示例

<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":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

商品API

alibaba.alsc.dish.category.create (阿里本地生活菜品分类创建)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

开放平台

商品API

alibaba.alsc.dish.category.create (阿里本地生活 菜品分类创建)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

alibaba.alsc.dish.category.create (阿里本地生活菜品分类创建)