POST api/hotel/agentsys/search
搜索酒店房间信息
Request Information
URI Parameters
None.
Body Parameters
相关协议数据
TC_HotelSearchRQContract| Name | Description | Type | Additional information |
|---|---|---|---|
| lang |
语言 |
string |
None. |
| citycode |
城市编码 |
string |
None. |
| coutrycode |
国家编码 |
string |
None. |
| regioncode | string |
None. |
|
| placeid | string |
None. |
|
| airportcode | string |
None. |
|
| nationality |
国籍 |
string |
None. |
| checkindate |
开始时间 |
date |
None. |
| checkoutdate |
结束时间 |
date |
None. |
| bookrooms |
预定信息 |
Collection of TC_BookRoomContract |
None. |
| hotelcodes |
酒店编码 |
Collection of string |
None. |
| mulithotelcodes | Collection of string |
None. |
|
| searchfromcache |
搜索从缓存 |
boolean |
None. |
| issearchtrack |
是否返回追踪信息 |
boolean |
None. |
| isloadlandmark | boolean |
None. |
|
| customersessionid | string |
None. |
|
| customeripaddress | string |
None. |
|
| customeruseragent | string |
None. |
|
| trackno | string |
None. |
|
| isroommerge | boolean |
None. |
|
| authuser |
用户身份信息 |
TC_UserContract |
None. |
Request Formats
application/json, text/json
Sample:
{
"lang": "sample string 1",
"citycode": "sample string 2",
"coutrycode": "sample string 3",
"regioncode": "sample string 4",
"placeid": "sample string 5",
"airportcode": "sample string 6",
"nationality": "sample string 7",
"checkindate": "2025-11-04T18:47:49.7419215+08:00",
"checkoutdate": "2025-11-04T18:47:49.7419215+08:00",
"bookrooms": [
{
"adultcount": 1,
"infantcount": 2,
"childages": [
1,
2
]
},
{
"adultcount": 1,
"infantcount": 2,
"childages": [
1,
2
]
}
],
"hotelcodes": [
"sample string 1",
"sample string 2"
],
"mulithotelcodes": [
"sample string 1",
"sample string 2"
],
"searchfromcache": true,
"issearchtrack": true,
"isloadlandmark": true,
"customersessionid": "sample string 16",
"customeripaddress": "sample string 17",
"customeruseragent": "sample string 18",
"trackno": "sample string 23",
"isroommerge": true,
"authuser": {
"userid": "sample string 1",
"password": "sample string 2"
}
}
application/x-www-form-urlencoded
Sample:
Response Information
Resource Description
搜索酒店房间信息
ReturnResultOfTC_HotelSearchRSContract| Name | Description | Type | Additional information |
|---|---|---|---|
| data | TC_HotelSearchRSContract |
None. |
|
| code |
状态码:100成功,其他自定义 |
integer |
None. |
| message |
提示消息 |
string |
None. |
Response Formats
application/json, text/json
Sample:
{
"data": {
"hotels": [
{
"hotelcode": "sample string 1",
"hotelname": "sample string 2",
"hotelengname": "sample string 3",
"citycode": "sample string 4",
"refcode": "sample string 5",
"regions": [
{
"regionid": "sample string 1",
"region": "sample string 2"
},
{
"regionid": "sample string 1",
"region": "sample string 2"
}
],
"address": "sample string 6",
"descript": "sample string 7",
"location": "sample string 8",
"star": 9.0,
"longitude": 10.1,
"latitude": 11.1,
"coverpic": "sample string 12",
"tripadrating": 13.1,
"tripadratingimgurl": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/13.1-52242-5.svg",
"tripadreviewcount": 14,
"checkininstructions": "sample string 15",
"checkinspecialinstructions": "sample string 16",
"rooms": [
{
"roomid": "sample string 1",
"roomname": "sample string 2",
"groupid": "sample string 3",
"groupname": "sample string 4",
"plansessiontoken": "sample string 5",
"status": "sample string 6",
"description": "sample string 7",
"allotment": 8,
"incentive": "sample string 9",
"surchargetotal": 10.0,
"total": 11.0,
"currency": "sample string 16",
"includebreakfast": "sample string 17",
"mealtype": "sample string 18",
"iswifi": "sample string 19",
"adultcount": 20,
"childcount": 21,
"promotions": [
{
"name": "sample string 1",
"description": "sample string 2"
},
{
"name": "sample string 1",
"description": "sample string 2"
}
],
"warns": [
{
"WarnTitle": "sample string 1",
"Descript": "sample string 2"
},
{
"WarnTitle": "sample string 1",
"Descript": "sample string 2"
}
],
"availableoptions": [
{
"optionid": "sample string 1",
"optionname": "sample string 2",
"rate": 3.0,
"currency": "sample string 4",
"compulsory": true
},
{
"optionid": "sample string 1",
"optionname": "sample string 2",
"rate": 3.0,
"currency": "sample string 4",
"compulsory": true
}
],
"roompernights": [
{
"date": "sample string 1",
"rate": 2.0,
"currency": "sample string 3"
},
{
"date": "sample string 1",
"rate": 2.0,
"currency": "sample string 3"
}
],
"roomimages": [
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
},
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
}
],
"additionals": [
{
"additionalid": "sample string 1",
"additional": "sample string 2"
},
{
"additionalid": "sample string 1",
"additional": "sample string 2"
}
],
"smokingpreferences": "sample string 22",
"bedtypes": [
{
"bedtypeid": "sample string 1",
"bedtype": "sample string 2"
},
{
"bedtypeid": "sample string 1",
"bedtype": "sample string 2"
}
],
"cancellationpolicy": "sample string 23",
"ispackage": true
},
{
"roomid": "sample string 1",
"roomname": "sample string 2",
"groupid": "sample string 3",
"groupname": "sample string 4",
"plansessiontoken": "sample string 5",
"status": "sample string 6",
"description": "sample string 7",
"allotment": 8,
"incentive": "sample string 9",
"surchargetotal": 10.0,
"total": 11.0,
"currency": "sample string 16",
"includebreakfast": "sample string 17",
"mealtype": "sample string 18",
"iswifi": "sample string 19",
"adultcount": 20,
"childcount": 21,
"promotions": [
{
"name": "sample string 1",
"description": "sample string 2"
},
{
"name": "sample string 1",
"description": "sample string 2"
}
],
"warns": [
{
"WarnTitle": "sample string 1",
"Descript": "sample string 2"
},
{
"WarnTitle": "sample string 1",
"Descript": "sample string 2"
}
],
"availableoptions": [
{
"optionid": "sample string 1",
"optionname": "sample string 2",
"rate": 3.0,
"currency": "sample string 4",
"compulsory": true
},
{
"optionid": "sample string 1",
"optionname": "sample string 2",
"rate": 3.0,
"currency": "sample string 4",
"compulsory": true
}
],
"roompernights": [
{
"date": "sample string 1",
"rate": 2.0,
"currency": "sample string 3"
},
{
"date": "sample string 1",
"rate": 2.0,
"currency": "sample string 3"
}
],
"roomimages": [
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
},
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
}
],
"additionals": [
{
"additionalid": "sample string 1",
"additional": "sample string 2"
},
{
"additionalid": "sample string 1",
"additional": "sample string 2"
}
],
"smokingpreferences": "sample string 22",
"bedtypes": [
{
"bedtypeid": "sample string 1",
"bedtype": "sample string 2"
},
{
"bedtypeid": "sample string 1",
"bedtype": "sample string 2"
}
],
"cancellationpolicy": "sample string 23",
"ispackage": true
}
],
"roomgroups": [
{
"groupid": "sample string 1",
"groupname": "sample string 2",
"groupdescript": "sample string 3",
"groupimages": [
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
},
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
}
]
},
{
"groupid": "sample string 1",
"groupname": "sample string 2",
"groupdescript": "sample string 3",
"groupimages": [
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
},
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
}
]
}
]
},
{
"hotelcode": "sample string 1",
"hotelname": "sample string 2",
"hotelengname": "sample string 3",
"citycode": "sample string 4",
"refcode": "sample string 5",
"regions": [
{
"regionid": "sample string 1",
"region": "sample string 2"
},
{
"regionid": "sample string 1",
"region": "sample string 2"
}
],
"address": "sample string 6",
"descript": "sample string 7",
"location": "sample string 8",
"star": 9.0,
"longitude": 10.1,
"latitude": 11.1,
"coverpic": "sample string 12",
"tripadrating": 13.1,
"tripadratingimgurl": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/13.1-52242-5.svg",
"tripadreviewcount": 14,
"checkininstructions": "sample string 15",
"checkinspecialinstructions": "sample string 16",
"rooms": [
{
"roomid": "sample string 1",
"roomname": "sample string 2",
"groupid": "sample string 3",
"groupname": "sample string 4",
"plansessiontoken": "sample string 5",
"status": "sample string 6",
"description": "sample string 7",
"allotment": 8,
"incentive": "sample string 9",
"surchargetotal": 10.0,
"total": 11.0,
"currency": "sample string 16",
"includebreakfast": "sample string 17",
"mealtype": "sample string 18",
"iswifi": "sample string 19",
"adultcount": 20,
"childcount": 21,
"promotions": [
{
"name": "sample string 1",
"description": "sample string 2"
},
{
"name": "sample string 1",
"description": "sample string 2"
}
],
"warns": [
{
"WarnTitle": "sample string 1",
"Descript": "sample string 2"
},
{
"WarnTitle": "sample string 1",
"Descript": "sample string 2"
}
],
"availableoptions": [
{
"optionid": "sample string 1",
"optionname": "sample string 2",
"rate": 3.0,
"currency": "sample string 4",
"compulsory": true
},
{
"optionid": "sample string 1",
"optionname": "sample string 2",
"rate": 3.0,
"currency": "sample string 4",
"compulsory": true
}
],
"roompernights": [
{
"date": "sample string 1",
"rate": 2.0,
"currency": "sample string 3"
},
{
"date": "sample string 1",
"rate": 2.0,
"currency": "sample string 3"
}
],
"roomimages": [
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
},
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
}
],
"additionals": [
{
"additionalid": "sample string 1",
"additional": "sample string 2"
},
{
"additionalid": "sample string 1",
"additional": "sample string 2"
}
],
"smokingpreferences": "sample string 22",
"bedtypes": [
{
"bedtypeid": "sample string 1",
"bedtype": "sample string 2"
},
{
"bedtypeid": "sample string 1",
"bedtype": "sample string 2"
}
],
"cancellationpolicy": "sample string 23",
"ispackage": true
},
{
"roomid": "sample string 1",
"roomname": "sample string 2",
"groupid": "sample string 3",
"groupname": "sample string 4",
"plansessiontoken": "sample string 5",
"status": "sample string 6",
"description": "sample string 7",
"allotment": 8,
"incentive": "sample string 9",
"surchargetotal": 10.0,
"total": 11.0,
"currency": "sample string 16",
"includebreakfast": "sample string 17",
"mealtype": "sample string 18",
"iswifi": "sample string 19",
"adultcount": 20,
"childcount": 21,
"promotions": [
{
"name": "sample string 1",
"description": "sample string 2"
},
{
"name": "sample string 1",
"description": "sample string 2"
}
],
"warns": [
{
"WarnTitle": "sample string 1",
"Descript": "sample string 2"
},
{
"WarnTitle": "sample string 1",
"Descript": "sample string 2"
}
],
"availableoptions": [
{
"optionid": "sample string 1",
"optionname": "sample string 2",
"rate": 3.0,
"currency": "sample string 4",
"compulsory": true
},
{
"optionid": "sample string 1",
"optionname": "sample string 2",
"rate": 3.0,
"currency": "sample string 4",
"compulsory": true
}
],
"roompernights": [
{
"date": "sample string 1",
"rate": 2.0,
"currency": "sample string 3"
},
{
"date": "sample string 1",
"rate": 2.0,
"currency": "sample string 3"
}
],
"roomimages": [
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
},
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
}
],
"additionals": [
{
"additionalid": "sample string 1",
"additional": "sample string 2"
},
{
"additionalid": "sample string 1",
"additional": "sample string 2"
}
],
"smokingpreferences": "sample string 22",
"bedtypes": [
{
"bedtypeid": "sample string 1",
"bedtype": "sample string 2"
},
{
"bedtypeid": "sample string 1",
"bedtype": "sample string 2"
}
],
"cancellationpolicy": "sample string 23",
"ispackage": true
}
],
"roomgroups": [
{
"groupid": "sample string 1",
"groupname": "sample string 2",
"groupdescript": "sample string 3",
"groupimages": [
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
},
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
}
]
},
{
"groupid": "sample string 1",
"groupname": "sample string 2",
"groupdescript": "sample string 3",
"groupimages": [
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
},
{
"url": "sample string 1",
"title": "sample string 2",
"descript": "sample string 3",
"isprimary": true
}
]
}
]
}
],
"trackinfos": [
{
"searchapi": "sample string 1",
"mapcity": "sample string 2",
"remark": "sample string 3",
"trackItems": [
{
"orghotelcode": "sample string 1",
"maphotelcode": "sample string 2"
},
{
"orghotelcode": "sample string 1",
"maphotelcode": "sample string 2"
}
]
},
{
"searchapi": "sample string 1",
"mapcity": "sample string 2",
"remark": "sample string 3",
"trackItems": [
{
"orghotelcode": "sample string 1",
"maphotelcode": "sample string 2"
},
{
"orghotelcode": "sample string 1",
"maphotelcode": "sample string 2"
}
]
}
],
"landmarkguid": "sample string 3",
"iscompleted": true
},
"code": 1,
"message": "sample string 2"
}