淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
adsim_batch_case_vo	AdsimBatchCaseVo	可选			场景批量添加对象
└ repeat_strategy String 可选 skip 场景重复策略，跳过/覆盖 case_v_o_list AdsimCaseVo [] 可选场景对象 └ creator_user_id Number 可选 1 场景创建者id └ sim_time Number 可选 123456789 simTime └ usr_defined_label String 可选 usrDefinedLabel usrDefinedLabel └ source_log_invalid_code Number 可选 1 场景失效标识 └ source String 可选 x_lab 场景来源 └ template_id Number 可选 0 场景模板id └ type String 可选 logSim 场景类型 └ scenario_definition_url String 可选 compose/case-definition/2020-12-17/5f8b2658-da8b-444e-9173-6dd49e7960cf/d21fede7-5c3d-4c1e-9053-9e9f8148cef1.yaml 场景yaml地址 └ source_docker_version String 可选 v4.3.3.77 场景来源版本 └ enable Number 可选 1 场景可用标识 └ copy_type String 可选 hard 场景复制类型 └ case_name String 可选场景名test 场景名 └ bag_start_time Number 可选 123456789 bagStartTime └ id Number 可选 1 场景id └ case_set_id Number 可选 7360 场景集id └ vehicle_type String 可选 G3 车辆类型 └ xgo_case_version String 可选 XIAOG_4.3 源场景版本 └ bag_end_time Number 可选 123456789 bagEndTime └ entry_time Number 可选 123456789 entryTime └ map_version String 可选 loc.20200928100356.1236 地图版本 └ extension String 可选 {} 拓展信息 └ auto_test_config String 可选 autoTestConfig autoTestConfig └ bag_label_type String 可选 bagLabelType bagLabelType └ description String 可选描述场景描述 └ remark String 可选备注场景备注 └ source_device_name String 可选 G3-006 源场景对应车辆名称 └ map_scene_name String 可选 hvy 地图名 └ test_object String 可选 xgo 待测对象 └ event_time Number 可选 123456789 eventTime └ source_aone_status String 可选 New 源场景aone状态 └ start_time Number 可选 123456789 startTime └ source_identity String 可选 33805400 源场景id └ sim_start_time Number 可选 123456789 simStartTime └ map_type String 可选 xlab.vector 地图类型 └ exit_time Number 可选 123456789 exitTime └ bag_label_info String 可选 bagLabelInfo bagLabelInfo └ source_device_udid String 可选 G3-006 源场景对应车辆udid └ end_time Number 可选 123456789 endTime └ source_aone_id String 可选 31427077 源场景对应aoneId └ scenario_data_version String 可选 1.0 场景编辑器版本 └ map_id Number 必须 168 地图ID └ scenario_content String 可选 "" yaml文件内容 └ case_set_id Number 必须 7360 目标场景集id

名称	类型	示例值	描述
result	DataResult		返回对象封装
└ code Number foo 参数code └ size Number 1 返回大小 └ data String 1 data └ success Boolean false 是否正常 └ message String message 结果信息 └ sequence_id String 123 响应id └ timestamp Number 123 响应时间戳

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAdlabAdsimCaseInfoImportRequest req = new AlibabaAdlabAdsimCaseInfoImportRequest();
AlibabaAdlabAdsimCaseInfoImportRequest.AdsimBatchCaseVo obj1 = new AlibabaAdlabAdsimCaseInfoImportRequest.AdsimBatchCaseVo();
obj1.setRepeatStrategy("skip");
List<AlibabaAdlabAdsimCaseInfoImportRequest.AdsimCaseVo> list3 = new ArrayList<AlibabaAdlabAdsimCaseInfoImportRequest.AdsimCaseVo>();
AlibabaAdlabAdsimCaseInfoImportRequest.AdsimCaseVo obj4 = new AlibabaAdlabAdsimCaseInfoImportRequest.AdsimCaseVo();
list3.add(obj4);
obj4.setCreatorUserId(1L);
obj4.setSimTime(123456789L);
obj4.setUsrDefinedLabel("usrDefinedLabel");
obj4.setSourceLogInvalidCode(1L);
obj4.setSource("x_lab");
obj4.setTemplateId(0L);
obj4.setType("logSim");
obj4.setScenarioDefinitionUrl("compose/case-definition/2020-12-17/5f8b2658-da8b-444e-9173-6dd49e7960cf/d21fede7-5c3d-4c1e-9053-9e9f8148cef1.yaml");
obj4.setSourceDockerVersion("v4.3.3.77");
obj4.setEnable(1L);
obj4.setCopyType("hard");
obj4.setCaseName("场景名test");
obj4.setBagStartTime(123456789L);
obj4.setId(1L);
obj4.setCaseSetId(7360L);
obj4.setVehicleType("G3");
obj4.setXgoCaseVersion("XIAOG_4.3");
obj4.setBagEndTime(123456789L);
obj4.setEntryTime(123456789L);
obj4.setMapVersion("loc.20200928100356.1236");
obj4.setExtension("{}");
obj4.setAutoTestConfig("autoTestConfig");
obj4.setBagLabelType("bagLabelType");
obj4.setDescription("描述");
obj4.setRemark("备注");
obj4.setSourceDeviceName("G3-006");
obj4.setMapSceneName("hvy");
obj4.setTestObject("xgo");
obj4.setEventTime(123456789L);
obj4.setSourceAoneStatus("New");
obj4.setStartTime(123456789L);
obj4.setSourceIdentity("33805400");
obj4.setSimStartTime(123456789L);
obj4.setMapType("xlab.vector");
obj4.setExitTime(123456789L);
obj4.setBagLabelInfo("bagLabelInfo");
obj4.setSourceDeviceUdid("G3-006");
obj4.setEndTime(123456789L);
obj4.setSourceAoneId("31427077");
obj4.setScenarioDataVersion("1.0");
obj4.setMapId(168L);
obj4.setScenarioContent("\"\"");
obj1.setCaseVOList(list3);
obj1.setCaseSetId(7360L);
req.setAdsimBatchCaseVo(obj1);
AlibabaAdlabAdsimCaseInfoImportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAdlabAdsimCaseInfoImportRequest req = new AlibabaAdlabAdsimCaseInfoImportRequest();
AlibabaAdlabAdsimCaseInfoImportRequest.AdsimBatchCaseVoDomain obj1 = new AlibabaAdlabAdsimCaseInfoImportRequest.AdsimBatchCaseVoDomain();
obj1.RepeatStrategy = "skip";
List<AlibabaAdlabAdsimCaseInfoImportRequest.AdsimCaseVoDomain> list3 = new List<AlibabaAdlabAdsimCaseInfoImportRequest.AdsimCaseVoDomain>();
AlibabaAdlabAdsimCaseInfoImportRequest.AdsimCaseVoDomain obj4 = new AlibabaAdlabAdsimCaseInfoImportRequest.AdsimCaseVoDomain();
list3.Add(obj4);
obj4.CreatorUserId = 1L;
obj4.SimTime = 123456789L;
obj4.UsrDefinedLabel = "usrDefinedLabel";
obj4.SourceLogInvalidCode = 1L;
obj4.Source = "x_lab";
obj4.TemplateId = 0L;
obj4.Type = "logSim";
obj4.ScenarioDefinitionUrl = "compose/case-definition/2020-12-17/5f8b2658-da8b-444e-9173-6dd49e7960cf/d21fede7-5c3d-4c1e-9053-9e9f8148cef1.yaml";
obj4.SourceDockerVersion = "v4.3.3.77";
obj4.Enable = 1L;
obj4.CopyType = "hard";
obj4.CaseName = "场景名test";
obj4.BagStartTime = 123456789L;
obj4.Id = 1L;
obj4.CaseSetId = 7360L;
obj4.VehicleType = "G3";
obj4.XgoCaseVersion = "XIAOG_4.3";
obj4.BagEndTime = 123456789L;
obj4.EntryTime = 123456789L;
obj4.MapVersion = "loc.20200928100356.1236";
obj4.Extension = "{}";
obj4.AutoTestConfig = "autoTestConfig";
obj4.BagLabelType = "bagLabelType";
obj4.Description = "描述";
obj4.Remark = "备注";
obj4.SourceDeviceName = "G3-006";
obj4.MapSceneName = "hvy";
obj4.TestObject = "xgo";
obj4.EventTime = 123456789L;
obj4.SourceAoneStatus = "New";
obj4.StartTime = 123456789L;
obj4.SourceIdentity = "33805400";
obj4.SimStartTime = 123456789L;
obj4.MapType = "xlab.vector";
obj4.ExitTime = 123456789L;
obj4.BagLabelInfo = "bagLabelInfo";
obj4.SourceDeviceUdid = "G3-006";
obj4.EndTime = 123456789L;
obj4.SourceAoneId = "31427077";
obj4.ScenarioDataVersion = "1.0";
obj4.MapId = 168L;
obj4.ScenarioContent = "\"\"";
obj1.CaseVOList= list3;
obj1.CaseSetId = 7360L;
req.AdsimBatchCaseVo_ = obj1;
AlibabaAdlabAdsimCaseInfoImportResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAdlabAdsimCaseInfoImportRequest;
$adsim_batch_case_vo = new AdsimBatchCaseVo;
$adsim_batch_case_vo->repeat_strategy="skip";
$case_v_o_list = new AdsimCaseVo;
$case_v_o_list->creator_user_id="1";
$case_v_o_list->sim_time="123456789";
$case_v_o_list->usr_defined_label="usrDefinedLabel";
$case_v_o_list->source_log_invalid_code="1";
$case_v_o_list->source="x_lab";
$case_v_o_list->template_id="0";
$case_v_o_list->type="logSim";
$case_v_o_list->scenario_definition_url="compose/case-definition/2020-12-17/5f8b2658-da8b-444e-9173-6dd49e7960cf/d21fede7-5c3d-4c1e-9053-9e9f8148cef1.yaml";
$case_v_o_list->source_docker_version="v4.3.3.77";
$case_v_o_list->enable="1";
$case_v_o_list->copy_type="hard";
$case_v_o_list->case_name="场景名test";
$case_v_o_list->bag_start_time="123456789";
$case_v_o_list->id="1";
$case_v_o_list->case_set_id="7360";
$case_v_o_list->vehicle_type="G3";
$case_v_o_list->xgo_case_version="XIAOG_4.3";
$case_v_o_list->bag_end_time="123456789";
$case_v_o_list->entry_time="123456789";
$case_v_o_list->map_version="loc.20200928100356.1236";
$case_v_o_list->extension="{}";
$case_v_o_list->auto_test_config="autoTestConfig";
$case_v_o_list->bag_label_type="bagLabelType";
$case_v_o_list->description="描述";
$case_v_o_list->remark="备注";
$case_v_o_list->source_device_name="G3-006";
$case_v_o_list->map_scene_name="hvy";
$case_v_o_list->test_object="xgo";
$case_v_o_list->event_time="123456789";
$case_v_o_list->source_aone_status="New";
$case_v_o_list->start_time="123456789";
$case_v_o_list->source_identity="33805400";
$case_v_o_list->sim_start_time="123456789";
$case_v_o_list->map_type="xlab.vector";
$case_v_o_list->exit_time="123456789";
$case_v_o_list->bag_label_info="bagLabelInfo";
$case_v_o_list->source_device_udid="G3-006";
$case_v_o_list->end_time="123456789";
$case_v_o_list->source_aone_id="31427077";
$case_v_o_list->scenario_data_version="1.0";
$case_v_o_list->map_id="168";
$case_v_o_list->scenario_content="\"\"";
$adsim_batch_case_vo->case_v_o_list = $case_v_o_list;
$adsim_batch_case_vo->case_set_id="7360";
$req->setAdsimBatchCaseVo(json_encode($adsim_batch_case_vo));
$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.adlab.adsim.case.info.import' \
-d 'partner_id=apidoc' \
-d 'sign=C4ED50C823EC139AC303CF3026F4FFB5' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-24+17%3A16%3A49' \
-d 'v=2.0' \
-d 'adsim_batch_case_vo=null'

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

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

req.adsim_batch_case_vo=""
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.adlab.adsim.case.info.import");
add_param(pRequest,"adsim_batch_case_vo","数据结构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.adlab.adsim.case.info.import', {
	'adsim_batch_case_vo':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_adlab_adsim_case_info_import_response>
    <result>
        <code>foo</code>
        <size>1</size>
        <data>1</data>
        <success>false</success>
        <message>message</message>
        <sequence_id>123</sequence_id>
        <timestamp>123</timestamp>
    </result>
</alibaba_adlab_adsim_case_info_import_response>

{
    "alibaba_adlab_adsim_case_info_import_response":{
        "result":{
            "code":foo,
            "size":1,
            "data":"1",
            "success":false,
            "message":"message",
            "sequence_id":"123",
            "timestamp":123
        }
    }
}

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下载

AD-LAB

alibaba.adlab.adsim.case.info.import (支持场景创建/导入)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ