淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
param_q_a_tag_upload_t_o	QaTagUploadTo	可选			上传参数对象
└ account_name String 必须 tony 上传账号名 └ appname String 必须 paas-backend 调用应用名 └ base_id String 可选 123124 调用账号id └ biz_type Number 必须 1 数据银行 └ brand_id String 可选 123123 品牌id └ data_set_id String 必须 123123 数据集id └ line_count Number 必须 123232 数据集行数 └ project_id Number 必须 213213 项目空间id qa_data_set_meta QaDataSetMeta 必须底层数据信息 d2store D2Store 必须 {} D2存储信息 └ condition String 可选 null null └ partition String 可选 12 odps分区 └ table_name String 必须 sdas odps表名 └ project_name String 必须 d odps项目空间名 └ cols String 可选 a,b,c odps列 └ entry_type String 必须 SHA256 加密算法 mapping_list MappingOption [] 必须匹配字段列表 └ mapping_field_name String 可选 uid 字段名称 └ mapping_type String 必须 TAOBAO_ID 匹配方式 tag_bos QaTagBo [] 必须标签字段列表 └ databank_tag_id String 可选 s123 标签id └ tag_name String 必须性别标签名 └ tag_nick String 必须性别1 标签别名 └ tag_type String 可选枚举字段类型 └ upload_type String 必须 COVER 覆盖、新增 └ tag_id String 必须 12313 qa侧标签id └ signature String 必须 1213 112312321 └ smart_id Number 可选 2131 组织id └ time_stamp Number 必须 231232132 时间戳

名称	类型	示例值	描述
result	RCode		返回结果
└ code_class String SUCCESS 错误码类型 data QaUploadResult {} 返回值 └ tagids String {} 标签id集合 └ upload_id String asdasdasd 上传id └ errcode Number 21312313 错误码 └ errmsg String 上传成功错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDatabankTagbackflowUploaddatasetRequest req = new AlibabaDatabankTagbackflowUploaddatasetRequest();
AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagUploadTo obj1 = new AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagUploadTo();
obj1.setAccountName("tony");
obj1.setAppname("paas-backend");
obj1.setBaseId("123124");
obj1.setBizType(1L);
obj1.setBrandId("123123");
obj1.setDataSetId("123123");
obj1.setLineCount(123232L);
obj1.setProjectId(213213L);
AlibabaDatabankTagbackflowUploaddatasetRequest.QaDataSetMeta obj2 = new AlibabaDatabankTagbackflowUploaddatasetRequest.QaDataSetMeta();
AlibabaDatabankTagbackflowUploaddatasetRequest.D2Store obj3 = new AlibabaDatabankTagbackflowUploaddatasetRequest.D2Store();
obj3.setCondition("null");
obj3.setPartition("12");
obj3.setTableName("sdas");
obj3.setProjectName("d");
obj3.setCols("a,b,c");
obj2.setD2store(obj3);
obj2.setEntryType("SHA256");
List<AlibabaDatabankTagbackflowUploaddatasetRequest.MappingOption> list5 = new ArrayList<AlibabaDatabankTagbackflowUploaddatasetRequest.MappingOption>();
AlibabaDatabankTagbackflowUploaddatasetRequest.MappingOption obj6 = new AlibabaDatabankTagbackflowUploaddatasetRequest.MappingOption();
list5.add(obj6);
obj6.setMappingFieldName("uid");
obj6.setMappingType("TAOBAO_ID");
obj2.setMappingList(list5);
List<AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagBo> list8 = new ArrayList<AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagBo>();
AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagBo obj9 = new AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagBo();
list8.add(obj9);
obj9.setDatabankTagId("s123");
obj9.setTagName("性别");
obj9.setTagNick("性别1");
obj9.setTagType("枚举");
obj9.setUploadType("COVER");
obj9.setTagId("12313");
obj2.setTagBos(list8);
obj1.setQaDataSetMeta(obj2);
obj1.setSignature("1213");
obj1.setSmartId(2131L);
obj1.setTimeStamp(231232132L);
req.setParamQATagUploadTO(obj1);
AlibabaDatabankTagbackflowUploaddatasetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDatabankTagbackflowUploaddatasetRequest req = new AlibabaDatabankTagbackflowUploaddatasetRequest();
AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagUploadToDomain obj1 = new AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagUploadToDomain();
obj1.AccountName = "tony";
obj1.Appname = "paas-backend";
obj1.BaseId = "123124";
obj1.BizType = 1L;
obj1.BrandId = "123123";
obj1.DataSetId = "123123";
obj1.LineCount = 123232L;
obj1.ProjectId = 213213L;
AlibabaDatabankTagbackflowUploaddatasetRequest.QaDataSetMetaDomain obj2 = new AlibabaDatabankTagbackflowUploaddatasetRequest.QaDataSetMetaDomain();
AlibabaDatabankTagbackflowUploaddatasetRequest.D2StoreDomain obj3 = new AlibabaDatabankTagbackflowUploaddatasetRequest.D2StoreDomain();
obj3.Condition = "null";
obj3.Partition = "12";
obj3.TableName = "sdas";
obj3.ProjectName = "d";
obj3.Cols = "a,b,c";
obj2.D2store= obj3;
obj2.EntryType = "SHA256";
List<AlibabaDatabankTagbackflowUploaddatasetRequest.MappingOptionDomain> list5 = new List<AlibabaDatabankTagbackflowUploaddatasetRequest.MappingOptionDomain>();
AlibabaDatabankTagbackflowUploaddatasetRequest.MappingOptionDomain obj6 = new AlibabaDatabankTagbackflowUploaddatasetRequest.MappingOptionDomain();
list5.Add(obj6);
obj6.MappingFieldName = "uid";
obj6.MappingType = "TAOBAO_ID";
obj2.MappingList= list5;
List<AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagBoDomain> list8 = new List<AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagBoDomain>();
AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagBoDomain obj9 = new AlibabaDatabankTagbackflowUploaddatasetRequest.QaTagBoDomain();
list8.Add(obj9);
obj9.DatabankTagId = "s123";
obj9.TagName = "性别";
obj9.TagNick = "性别1";
obj9.TagType = "枚举";
obj9.UploadType = "COVER";
obj9.TagId = "12313";
obj2.TagBos= list8;
obj1.QaDataSetMeta= obj2;
obj1.Signature = "1213";
obj1.SmartId = 2131L;
obj1.TimeStamp = 231232132L;
req.ParamQATagUploadTO_ = obj1;
AlibabaDatabankTagbackflowUploaddatasetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDatabankTagbackflowUploaddatasetRequest;
$param_q_a_tag_upload_t_o = new QaTagUploadTo;
$param_q_a_tag_upload_t_o->account_name="tony";
$param_q_a_tag_upload_t_o->appname="paas-backend";
$param_q_a_tag_upload_t_o->base_id="123124";
$param_q_a_tag_upload_t_o->biz_type="1";
$param_q_a_tag_upload_t_o->brand_id="123123";
$param_q_a_tag_upload_t_o->data_set_id="123123";
$param_q_a_tag_upload_t_o->line_count="123232";
$param_q_a_tag_upload_t_o->project_id="213213";
$qa_data_set_meta = new QaDataSetMeta;
$d2store = new D2Store;
$d2store->condition="null";
$d2store->partition="12";
$d2store->table_name="sdas";
$d2store->project_name="d";
$d2store->cols="a,b,c";
$qa_data_set_meta->d2store = $d2store;
$qa_data_set_meta->entry_type="SHA256";
$mapping_list = new MappingOption;
$mapping_list->mapping_field_name="uid";
$mapping_list->mapping_type="TAOBAO_ID";
$qa_data_set_meta->mapping_list = $mapping_list;
$tag_bos = new QaTagBo;
$tag_bos->databank_tag_id="s123";
$tag_bos->tag_name="性别";
$tag_bos->tag_nick="性别1";
$tag_bos->tag_type="枚举";
$tag_bos->upload_type="COVER";
$tag_bos->tag_id="12313";
$qa_data_set_meta->tag_bos = $tag_bos;
$param_q_a_tag_upload_t_o->qa_data_set_meta = $qa_data_set_meta;
$param_q_a_tag_upload_t_o->signature="1213";
$param_q_a_tag_upload_t_o->smart_id="2131";
$param_q_a_tag_upload_t_o->time_stamp="231232132";
$req->setParamQATagUploadTO(json_encode($param_q_a_tag_upload_t_o));
$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.databank.tagbackflow.uploaddataset' \
-d 'partner_id=apidoc' \
-d 'sign=E236C6516804EB473CF9DB5EFDE447C5' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-05+16%3A13%3A13' \
-d 'v=2.0' \
-d 'param_q_a_tag_upload_t_o=null'

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

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

req.param_q_a_tag_upload_t_o=""
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.databank.tagbackflow.uploaddataset");
add_param(pRequest,"param_q_a_tag_upload_t_o","数据结构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.databank.tagbackflow.uploaddataset', {
	'param_q_a_tag_upload_t_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_databank_tagbackflow_uploaddataset_response>
    <result>
        <code_class>SUCCESS</code_class>
        <data>
            <tagids>{}</tagids>
            <upload_id>asdasdasd</upload_id>
        </data>
        <errcode>21312313</errcode>
        <errmsg>上传成功</errmsg>
    </result>
</alibaba_databank_tagbackflow_uploaddataset_response>

{
    "alibaba_databank_tagbackflow_uploaddataset_response":{
        "result":{
            "code_class":"SUCCESS",
            "data":{
                "tagids":"{}",
                "upload_id":"asdasdasd"
            },
            "errcode":21312313,
            "errmsg":"上传成功"
        }
    }
}

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.databank.tagbackflow.uploaddataset (标签回流(上传))

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ