淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	描述
caid_md5	String	可选	caidmd5	caid md5哈希
event_id	Number	可选	12345	星任务id
oaid_md5	String	可选	oaidmd5	oaid md5哈希
os	String	可选	1	设备类型 0：其他，1：安卓，2：IOS
idfa	String	可选	idfa	idfa原值
content_id	String	可选	123	内容id
traffic_type	String	可选	1	流量类型：1.全部 2.自然 3.商业化
opt_type	Number	可选	1	操作标记（补数场景使用） 1.增量补数 2.全量补数
biz	String	可选	shangdan	业务线
ad_type	String	可选	1	广告类型 1.视频信息流 2.动态广告
idfa_md5	String	可选	abc123	idfa md5哈希
caid	String	可选	abc123	caid原值
imei_md5	String	可选	abc123	imei md5哈希
imei	String	可选	abc123	imei原值
id	String	可选	abc123	唯一id
behaviour_type	Number	可选	1	行为类型：1.曝光 2.点击
oaid	String	可选	abc123	oaid原值
time	String	可选	1718873189000	数据发生时间
campaign_id	String	可选	abc123	计划id（任务id）
unit_id	String	可选	abc123	单元id（订单id）
creative_id	String	可选	abc123	创意id
account_id	String	可选	abc123	账户id
ip	String	可选	0.0.0.0	ipv4
ua	String	可选	user-agent	ua
model	String	可选	iphone15Pro	设备
star_id	String	可选	abc123	达人id
callback_url	String	可选	www.xxx.com	回调地址
landing	String	可选	www.xxx.com	落地页

名称	类型	示例值	描述
data	TrackDTO		结果
└ success Boolean true 是否成功
result_code	Number	200	返回码
biz_error_desc	String	系统异常	业务错误码
result_msg	String	内部服务发生错误	错误信息
biz_error_code	Number	1001	业务错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkFeedTrackUploadRequest req = new TbkFeedTrackUploadRequest();
req.setCaidMd5("caidmd5");
req.setEventId(12345L);
req.setOaidMd5("oaidmd5");
req.setOs("1");
req.setIdfa("idfa");
req.setContentId("123");
req.setTrafficType("1");
req.setOptType(1L);
req.setBiz("shangdan");
req.setAdType("1");
req.setIdfaMd5("abc123");
req.setCaid("abc123");
req.setImeiMd5("abc123");
req.setImei("abc123");
req.setId("abc123");
req.setBehaviourType(1L);
req.setOaid("abc123");
req.setTime("1718873189000");
req.setCampaignId("abc123");
req.setUnitId("abc123");
req.setCreativeId("abc123");
req.setAccountId("abc123");
req.setIp("0.0.0.0");
req.setUa("user-agent");
req.setModel("iphone15Pro");
req.setStarId("abc123");
req.setCallbackUrl("www.xxx.com");
req.setLanding("www.xxx.com");
TbkFeedTrackUploadResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TbkFeedTrackUploadRequest req = new TbkFeedTrackUploadRequest();
req.CaidMd5 = "caidmd5";
req.EventId = 12345L;
req.OaidMd5 = "oaidmd5";
req.Os = "1";
req.Idfa = "idfa";
req.ContentId = "123";
req.TrafficType = "1";
req.OptType = 1L;
req.Biz = "shangdan";
req.AdType = "1";
req.IdfaMd5 = "abc123";
req.Caid = "abc123";
req.ImeiMd5 = "abc123";
req.Imei = "abc123";
req.Id = "abc123";
req.BehaviourType = 1L;
req.Oaid = "abc123";
req.Time = "1718873189000";
req.CampaignId = "abc123";
req.UnitId = "abc123";
req.CreativeId = "abc123";
req.AccountId = "abc123";
req.Ip = "0.0.0.0";
req.Ua = "user-agent";
req.Model = "iphone15Pro";
req.StarId = "abc123";
req.CallbackUrl = "www.xxx.com";
req.Landing = "www.xxx.com";
TbkFeedTrackUploadResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TbkFeedTrackUploadRequest;
$req->setCaidMd5("caidmd5");
$req->setEventId("12345");
$req->setOaidMd5("oaidmd5");
$req->setOs("1");
$req->setIdfa("idfa");
$req->setContentId("123");
$req->setTrafficType("1");
$req->setOptType("1");
$req->setBiz("shangdan");
$req->setAdType("1");
$req->setIdfaMd5("abc123");
$req->setCaid("abc123");
$req->setImeiMd5("abc123");
$req->setImei("abc123");
$req->setId("abc123");
$req->setBehaviourType("1");
$req->setOaid("abc123");
$req->setTime("1718873189000");
$req->setCampaignId("abc123");
$req->setUnitId("abc123");
$req->setCreativeId("abc123");
$req->setAccountId("abc123");
$req->setIp("0.0.0.0");
$req->setUa("user-agent");
$req->setModel("iphone15Pro");
$req->setStarId("abc123");
$req->setCallbackUrl("www.xxx.com");
$req->setLanding("www.xxx.com");
$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=taobao.tbk.feed.track.upload' \
-d 'partner_id=apidoc' \
-d 'sign=142637DCE37EE72F95583BF959CB0E19' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-01-16+00%3A58%3A56' \
-d 'v=2.0' \
-d 'account_id=abc123' \
-d 'ad_type=1' \
-d 'behaviour_type=1' \
-d 'biz=shangdan' \
-d 'caid=abc123' \
-d 'caid_md5=caidmd5' \
-d 'callback_url=www.xxx.com' \
-d 'campaign_id=abc123' \
-d 'content_id=123' \
-d 'creative_id=abc123' \
-d 'event_id=12345' \
-d 'id=abc123' \
-d 'idfa=idfa' \
-d 'idfa_md5=abc123' \
-d 'imei=abc123' \
-d 'imei_md5=abc123' \
-d 'ip=0.0.0.0' \
-d 'landing=www.xxx.com' \
-d 'model=iphone15Pro' \
-d 'oaid=abc123' \
-d 'oaid_md5=oaidmd5' \
-d 'opt_type=1' \
-d 'os=1' \
-d 'star_id=abc123' \
-d 'time=1718873189000' \
-d 'traffic_type=1' \
-d 'ua=user-agent' \
-d 'unit_id=abc123'

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

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

req.caid_md5="caidmd5"
req.event_id=12345
req.oaid_md5="oaidmd5"
req.os="1"
req.idfa="idfa"
req.content_id="123"
req.traffic_type="1"
req.opt_type=1
req.biz="shangdan"
req.ad_type="1"
req.idfa_md5="abc123"
req.caid="abc123"
req.imei_md5="abc123"
req.imei="abc123"
req.id="abc123"
req.behaviour_type=1
req.oaid="abc123"
req.time="1718873189000"
req.campaign_id="abc123"
req.unit_id="abc123"
req.creative_id="abc123"
req.account_id="abc123"
req.ip="0.0.0.0"
req.ua="user-agent"
req.model="iphone15Pro"
req.star_id="abc123"
req.callback_url="www.xxx.com"
req.landing="www.xxx.com"
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,"taobao.tbk.feed.track.upload");
add_param(pRequest,"caid_md5","caidmd5");
add_param(pRequest,"event_id","12345");
add_param(pRequest,"oaid_md5","oaidmd5");
add_param(pRequest,"os","1");
add_param(pRequest,"idfa","idfa");
add_param(pRequest,"content_id","123");
add_param(pRequest,"traffic_type","1");
add_param(pRequest,"opt_type","1");
add_param(pRequest,"biz","shangdan");
add_param(pRequest,"ad_type","1");
add_param(pRequest,"idfa_md5","abc123");
add_param(pRequest,"caid","abc123");
add_param(pRequest,"imei_md5","abc123");
add_param(pRequest,"imei","abc123");
add_param(pRequest,"id","abc123");
add_param(pRequest,"behaviour_type","1");
add_param(pRequest,"oaid","abc123");
add_param(pRequest,"time","1718873189000");
add_param(pRequest,"campaign_id","abc123");
add_param(pRequest,"unit_id","abc123");
add_param(pRequest,"creative_id","abc123");
add_param(pRequest,"account_id","abc123");
add_param(pRequest,"ip","0.0.0.0");
add_param(pRequest,"ua","user-agent");
add_param(pRequest,"model","iphone15Pro");
add_param(pRequest,"star_id","abc123");
add_param(pRequest,"callback_url","www.xxx.com");
add_param(pRequest,"landing","www.xxx.com");
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('taobao.tbk.feed.track.upload', {
	'caid_md5':'caidmd5',
	'event_id':'12345',
	'oaid_md5':'oaidmd5',
	'os':'1',
	'idfa':'idfa',
	'content_id':'123',
	'traffic_type':'1',
	'opt_type':'1',
	'biz':'shangdan',
	'ad_type':'1',
	'idfa_md5':'abc123',
	'caid':'abc123',
	'imei_md5':'abc123',
	'imei':'abc123',
	'id':'abc123',
	'behaviour_type':'1',
	'oaid':'abc123',
	'time':'1718873189000',
	'campaign_id':'abc123',
	'unit_id':'abc123',
	'creative_id':'abc123',
	'account_id':'abc123',
	'ip':'0.0.0.0',
	'ua':'user-agent',
	'model':'iphone15Pro',
	'star_id':'abc123',
	'callback_url':'www.xxx.com',
	'landing':'www.xxx.com'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tbk_feed_track_upload_response>
    <data>
        <success>true</success>
    </data>
    <result_code>200</result_code>
    <biz_error_desc>系统异常</biz_error_desc>
    <result_msg>内部服务发生错误</result_msg>
    <biz_error_code>1001</biz_error_code>
</tbk_feed_track_upload_response>

{
    "tbk_feed_track_upload_response":{
        "data":{
            "success":true
        },
        "result_code":200,
        "biz_error_desc":"系统异常",
        "result_msg":"内部服务发生错误",
        "biz_error_code":1001
    }
}

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

taobao.tbk.feed.track.upload (通用用户监测数据上传)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ