阿里安全开放平台-阿里聚安全

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
fsc_project_update_request	FscProjectModifyRequest	必须			fscProjectUpdateRequest
└ product_code String 可选 xxxxx 产品编号 └ journey_code String 可选 xxxxx 行程编号 project_list FscRouteProjectApiDto [] 可选团期列表 └ date String 可选 2023-04-20 出团日期格式yyyy-MM-dd └ project_code String 可选 C123456 团期计划编号 price_list FscRouteProjectPriceApiDto [] 可选 - 价格体系 └ price_category String 可选 xxxxx 价格类型 ADULT:成人价 CHILD:儿童价 └ price Number 可选 3 同行价 └ promotion_price Number 可选 3 加返 └ sale_price Number 可选 3 门市价 └ contact_name String 可选张三联系人姓名 └ contact_phone String 可选 12345678901 联系人电话 └ booking_unit_price Number 可选 100 订金单价(单位分) └ end_sign_date String 可选 2023-12-31 截止报名日期 fsc_sale_commission FscSaleCommissionApiDTO 可选佣金设置 └ commission_type String 可选 ABSOLUTE_VALUE 佣金类型 └ commission_num String 可选 10 佣金数值 depart_flight FlightInfoApiDTO 可选去程航班 └ day String 可选 1 行程天数第几天 └ date String 可选 2023-07-10 行程日期 yyyy-MM-dd └ flight_code String 可选 CA0001 航班号 └ airline_code String 可选 CA 航空公司代码 └ start_city String 可选罗马出发城市名称 └ start_time String 可选 1820 起飞时间HHmm(时分) └ start_airport String 可选 HKG 起飞机场代码机场三字码 └ arrive_city String 可选北京抵达城市 └ arrive_time String 可选 1820 抵达时间HHmm(时分) └ arrive_airport String 可选 HKG 降落机场代码 └ buy_out Boolean 可选 false 是否包机 true-是false-否 └ flight_type String 可选中型机型 └ cabin_type String 可选经济舱舱型 return_flight FlightInfoApiDTO 可选返程航班 └ day String 可选 1 行程天数第几天 └ date String 可选 2023-07-10 行程日期 yyyy-MM-dd └ flight_code String 可选 CA0001 航班号 └ airline_code String 可选 CA 航空公司代码 └ start_city String 可选罗马出发城市名称 └ start_time String 可选 1820 起飞时间HHmm(时分) └ start_airport String 可选 HKG 起飞机场代码机场三字码 └ arrive_city String 可选北京抵达城市 └ arrive_time String 可选 1820 抵达时间HHmm(时分) └ arrive_airport String 可选 HKG 降落机场代码 └ buy_out Boolean 可选 false 是否包机 true-是false-否 └ flight_type String 可选中型机型 └ cabin_type String 可选经济舱舱型 └ supplier_id String 可选 xxxxx 供应商ID

名称	类型	示例值	描述
top_result	TopResult		通用返回结果
└ success Boolean true 是否成功 └ error_code String SYSTEM_ERROR 错误码 └ error_msg String 授权异常错误信息 └ data Boolean false 业务数据

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelFscRouteApiProjectUpdateRequest req = new AlitripTravelFscRouteApiProjectUpdateRequest();
AlitripTravelFscRouteApiProjectUpdateRequest.FscProjectModifyRequest obj1 = new AlitripTravelFscRouteApiProjectUpdateRequest.FscProjectModifyRequest();
obj1.setProductCode("xxxxx");
obj1.setJourneyCode("xxxxx");
List<AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectApiDto> list3 = new ArrayList<AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectApiDto>();
AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectApiDto obj4 = new AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectApiDto();
list3.add(obj4);
obj4.setDate("2023-04-20");
obj4.setProjectCode("C123456");
List<AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectPriceApiDto> list7 = new ArrayList<AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectPriceApiDto>();
AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectPriceApiDto obj8 = new AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectPriceApiDto();
list7.add(obj8);
obj8.setPriceCategory("xxxxx");
obj8.setPrice(3L);
obj8.setPromotionPrice(3L);
obj8.setSalePrice(3L);
list5.setPriceList(list7);
obj4.setContactName("张三");
obj4.setContactPhone("12345678901");
obj4.setBookingUnitPrice(100L);
obj4.setEndSignDate("2023-12-31");
AlitripTravelFscRouteApiProjectUpdateRequest.FscSaleCommissionApiDTO obj10 = new AlitripTravelFscRouteApiProjectUpdateRequest.FscSaleCommissionApiDTO();
obj10.setCommissionType("ABSOLUTE_VALUE");
obj10.setCommissionNum("10");
list9.setFscSaleCommission(obj10);
AlitripTravelFscRouteApiProjectUpdateRequest.FlightInfoApiDTO obj12 = new AlitripTravelFscRouteApiProjectUpdateRequest.FlightInfoApiDTO();
obj12.setDay("1");
obj12.setDate("2023-07-10");
obj12.setFlightCode("CA0001");
obj12.setAirlineCode("CA");
obj12.setStartCity("罗马");
obj12.setStartTime("1820");
obj12.setStartAirport("HKG");
obj12.setArriveCity("北京");
obj12.setArriveTime("1820");
obj12.setArriveAirport("HKG");
obj12.setBuyOut(false);
obj12.setFlightType("中型");
obj12.setCabinType("经济舱");
list11.setDepartFlight(obj12);
AlitripTravelFscRouteApiProjectUpdateRequest.FlightInfoApiDTO obj14 = new AlitripTravelFscRouteApiProjectUpdateRequest.FlightInfoApiDTO();
obj14.setDay("1");
obj14.setDate("2023-07-10");
obj14.setFlightCode("CA0001");
obj14.setAirlineCode("CA");
obj14.setStartCity("罗马");
obj14.setStartTime("1820");
obj14.setStartAirport("HKG");
obj14.setArriveCity("北京");
obj14.setArriveTime("1820");
obj14.setArriveAirport("HKG");
obj14.setBuyOut(false);
obj14.setFlightType("中型");
obj14.setCabinType("经济舱");
list13.setReturnFlight(obj14);
obj1.setProjectList(list3);
obj1.setSupplierId("xxxxx");
req.setFscProjectUpdateRequest(obj1);
AlitripTravelFscRouteApiProjectUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripTravelFscRouteApiProjectUpdateRequest req = new AlitripTravelFscRouteApiProjectUpdateRequest();
AlitripTravelFscRouteApiProjectUpdateRequest.FscProjectModifyRequestDomain obj1 = new AlitripTravelFscRouteApiProjectUpdateRequest.FscProjectModifyRequestDomain();
obj1.ProductCode = "xxxxx";
obj1.JourneyCode = "xxxxx";
List<AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectApiDtoDomain> list3 = new List<AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectApiDtoDomain>();
AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectApiDtoDomain obj4 = new AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectApiDtoDomain();
list3.Add(obj4);
obj4.Date = "2023-04-20";
obj4.ProjectCode = "C123456";
List<AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectPriceApiDtoDomain> list6 = new List<AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectPriceApiDtoDomain>();
AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectPriceApiDtoDomain obj7 = new AlitripTravelFscRouteApiProjectUpdateRequest.FscRouteProjectPriceApiDtoDomain();
list6.Add(obj7);
obj7.PriceCategory = "xxxxx";
obj7.Price = 3L;
obj7.PromotionPrice = 3L;
obj7.SalePrice = 3L;
obj4.PriceList= list6;
obj4.ContactName = "张三";
obj4.ContactPhone = "12345678901";
obj4.BookingUnitPrice = 100L;
obj4.EndSignDate = "2023-12-31";
AlitripTravelFscRouteApiProjectUpdateRequest.FscSaleCommissionApiDTODomain obj8 = new AlitripTravelFscRouteApiProjectUpdateRequest.FscSaleCommissionApiDTODomain();
obj8.CommissionType = "ABSOLUTE_VALUE";
obj8.CommissionNum = "10";
obj4.FscSaleCommission= obj8;
AlitripTravelFscRouteApiProjectUpdateRequest.FlightInfoApiDTODomain obj9 = new AlitripTravelFscRouteApiProjectUpdateRequest.FlightInfoApiDTODomain();
obj9.Day = "1";
obj9.Date = "2023-07-10";
obj9.FlightCode = "CA0001";
obj9.AirlineCode = "CA";
obj9.StartCity = "罗马";
obj9.StartTime = "1820";
obj9.StartAirport = "HKG";
obj9.ArriveCity = "北京";
obj9.ArriveTime = "1820";
obj9.ArriveAirport = "HKG";
obj9.BuyOut = false;
obj9.FlightType = "中型";
obj9.CabinType = "经济舱";
obj4.DepartFlight= obj9;
AlitripTravelFscRouteApiProjectUpdateRequest.FlightInfoApiDTODomain obj10 = new AlitripTravelFscRouteApiProjectUpdateRequest.FlightInfoApiDTODomain();
obj10.Day = "1";
obj10.Date = "2023-07-10";
obj10.FlightCode = "CA0001";
obj10.AirlineCode = "CA";
obj10.StartCity = "罗马";
obj10.StartTime = "1820";
obj10.StartAirport = "HKG";
obj10.ArriveCity = "北京";
obj10.ArriveTime = "1820";
obj10.ArriveAirport = "HKG";
obj10.BuyOut = false;
obj10.FlightType = "中型";
obj10.CabinType = "经济舱";
obj4.ReturnFlight= obj10;
obj1.ProjectList= list3;
obj1.SupplierId = "xxxxx";
req.FscProjectUpdateRequest_ = obj1;
AlitripTravelFscRouteApiProjectUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripTravelFscRouteApiProjectUpdateRequest;
$fsc_project_update_request = new FscProjectModifyRequest;
$fsc_project_update_request->product_code="xxxxx";
$fsc_project_update_request->journey_code="xxxxx";
$project_list = new FscRouteProjectApiDto;
$project_list->date="2023-04-20";
$project_list->project_code="C123456";
$price_list = new FscRouteProjectPriceApiDto;
$price_list->price_category="xxxxx";
$price_list->price="3";
$price_list->promotion_price="3";
$price_list->sale_price="3";
$project_list->price_list = $price_list;
$project_list->contact_name="张三";
$project_list->contact_phone="12345678901";
$project_list->booking_unit_price="100";
$project_list->end_sign_date="2023-12-31";
$fsc_sale_commission = new FscSaleCommissionApiDTO;
$fsc_sale_commission->commission_type="ABSOLUTE_VALUE";
$fsc_sale_commission->commission_num="10";
$project_list->fsc_sale_commission = $fsc_sale_commission;
$depart_flight = new FlightInfoApiDTO;
$depart_flight->day="1";
$depart_flight->date="2023-07-10";
$depart_flight->flight_code="CA0001";
$depart_flight->airline_code="CA";
$depart_flight->start_city="罗马";
$depart_flight->start_time="1820";
$depart_flight->start_airport="HKG";
$depart_flight->arrive_city="北京";
$depart_flight->arrive_time="1820";
$depart_flight->arrive_airport="HKG";
$depart_flight->buy_out="false";
$depart_flight->flight_type="中型";
$depart_flight->cabin_type="经济舱";
$project_list->depart_flight = $depart_flight;
$return_flight = new FlightInfoApiDTO;
$return_flight->day="1";
$return_flight->date="2023-07-10";
$return_flight->flight_code="CA0001";
$return_flight->airline_code="CA";
$return_flight->start_city="罗马";
$return_flight->start_time="1820";
$return_flight->start_airport="HKG";
$return_flight->arrive_city="北京";
$return_flight->arrive_time="1820";
$return_flight->arrive_airport="HKG";
$return_flight->buy_out="false";
$return_flight->flight_type="中型";
$return_flight->cabin_type="经济舱";
$project_list->return_flight = $return_flight;
$fsc_project_update_request->project_list = $project_list;
$fsc_project_update_request->supplier_id="xxxxx";
$req->setFscProjectUpdateRequest(json_encode($fsc_project_update_request));
$resp = $c->execute($req, $sessionKey);

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.alitrip.travel.fsc.route.api.project.update' \
-d 'partner_id=apidoc' \
-d 'session=9935c6d9-735f-4f04-9ed4-2e561e8cc03c' \
-d 'sign=B0E536A530471434743FC62FD5762243' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-26+03%3A06%3A15' \
-d 'v=2.0' \
-d 'fsc_project_update_request=null'

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

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

req.fsc_project_update_request="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	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.alitrip.travel.fsc.route.api.project.update");
add_param(pRequest,"fsc_project_update_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
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.alitrip.travel.fsc.route.api.project.update', {
	'fsc_project_update_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_travel_fsc_route_api_project_update_response>
    <top_result>
        <success>true</success>
        <error_code>SYSTEM_ERROR</error_code>
        <error_msg>授权异常</error_msg>
        <data>false</data>
    </top_result>
</alitrip_travel_fsc_route_api_project_update_response>

{
    "alitrip_travel_fsc_route_api_project_update_response":{
        "top_result":{
            "success":true,
            "error_code":"SYSTEM_ERROR",
            "error_msg":"授权异常",
            "data":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下载

阿信-基础数据

taobao.alitrip.travel.fsc.route.api.project.update (更新团期)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈