旅游与活动API
用于旅游团、活动和景点门票的旅游活动API
旅游活动API可以把活动供应商的导览团、一日游、体验项目和景点门票放到您自己的网站上销售。本页介绍通过API获取的内容长什么样:场次与名额、按旅客类型的价格、预订时供应商要求回答的问题,以及旅客当天出示的凭证。
- 日期、场次与名额
- 成人、儿童、婴儿和老人价格
- 凭证与手机电子票
- 自有行程与API库存并存
可销售的产品
旅游活动API能卖什么
活动供应商把差异很大的产品放在同一个API下。它们的预订模式相同(日期、通常还有时间,以及各年龄段的人数),但每种产品类型都有各自需要在网站上展示的信息。
导览团
城市徒步、博物馆参观和美食之旅,配有向导,注明集合地点、出发时间和导游语言。
一日游
从城市出发的全天行程,通常注明是否包含酒店接送、交通和午餐。
景点门票
博物馆、地标、主题乐园和动物园:不限日期或指定时段入场,常有免排队选项。
体验项目
烹饪课、游船、演出和户外活动,每项的时长和团队规模各不相同。
多日游
为期数天的行程,含逐日安排、住宿和固定的出发日期。
含接送的行程
附带酒店或港口往返接送的活动,接送信息也是预订的一部分。

多数旅行社会在同一个网站上把这些产品与机票和酒店组合销售。了解旅游API如何配合。
出发时间
- 09:30已售罄
- 14:00已售罄
- 14:00已售罄
示意数据
可订状态
日期、场次和剩余名额
旅客付款之前,API会告诉您的网站哪些日期可订、当天有哪些出发时间,以及每个场次还剩多少名额。
- 实时库存
- 供应商为每个场次设置名额,API返回剩余数量。付款前网站会再次核对,因为其他销售方可能已经订走了最后几个名额。
- 自由销售
- 部分产品没有固定配额:供应商允许合作伙伴自由销售并确认每一笔预订,直到关闭某个日期或场次。
- 按请求确认
- 少数产品需要供应商逐笔手动接受预订。在确认或拒绝之前,预订保持待处理状态,所以必须在付款前告知旅客。
- 截止时间
- 销售通常在开始前若干小时关闭。早上还显示可订的场次,下午可能就没有了。
定价
按旅客类型定价,而不是整单一个价格
活动按年龄段定价。年龄段由供应商为每个产品设定,总价是订单中每位旅客价格之和。
| 旅客类型 | 年龄段 | 单价 | 人数 | 小计 |
|---|---|---|---|---|
| 成人 | 18至64岁 | – | 2 | – |
| 儿童 | 4至17岁 | – | 1 | – |
| 婴儿 | 0至3岁 | 免费 | 1 | – |
| 老人 | 65岁及以上 | – | 0 | – |
| 4位旅客合计您的加价会叠加在供应商价格之上 | – | |||
- 01
年龄段因产品而异
儿童在一个行程里可能是3至12岁,在另一个里是4至17岁。网站必须读取每个产品自己的年龄段,而不能对所有产品套用同一条规则。
- 02
最少与最多人数
产品会限定一笔预订可包含的人数,有些在儿童或婴儿同行时还要求至少一名成人。
- 03
按人或按单位
包团行程、船只和车辆通常按团队或按车辆(在额定人数内)定价,而不是按旅客计价。
- 04
免费不等于不计人数
免费的婴儿仍然计入总人数,因此会随订单一并提交,并显示在凭证上。
预订问题
供应商接受预订前需要旅客回答的问题
很多活动仅凭姓名和邮箱无法成行。每个产品可以带有自己的必填问题,缺少答案时预订会被拒绝。
- 按订单只问一次:接送酒店、抵达航班、当天可联系的手机号。
- 按旅客每个人都要填:全名、年龄,有些活动还需要身高、体重或护照号码。
- 固定选项导游语言或接送地点由供应商提供选项列表,旅客直接选择而无需输入。
好的预订流程会在结账时用旅客的语言提出这些问题,并把答案随订单一起传给供应商,让导游在活动当天之前就能收到。
- 接送地点必填
- 市中心酒店大堂
- 行程语言必填
- 西班牙语
- 饮食要求选填
- 一位素食者,不含坚果
- 主要旅客电话必填
- +00 000 000 000
活动当天
凭证才是旅客真正拿在手里的产品
供应商确认后,API会返回旅客在入口或集合点出示的内容:一个二维码或代码、供应商订单号,以及实用的出行信息。
预订凭证
本地向导带队的老城区徒步游
- 日期
- 2026年11月14日 周六
- 出发
- 09:30
- 旅客
- 2位成人、1位儿童、1位婴儿
- 集合地点
- 中央广场,钟楼旁
- 供应商订单号
- TR-48210-KQ
- 已确认
- 已确认
- 手机电子版或纸质版
许多产品接受手机上的代码,也有些仍要求打印凭证。产品会注明是哪一种,您的确认信息也应重复说明。
- 即时确认
大多数API产品几秒内即可确认,凭证随即生成,可以随预订确认邮件一起发出。
- 按请求确认
按请求确认的产品要等供应商接受后才发出凭证,所以付款后需要持续跟踪预订状态。
- 取消政策
每个产品都有各自的退款规则,通常是在开始前一定时间之前可免费取消。请在付款前以及凭证上展示这些规则。
PHPTRAVELS已就绪
用您自己的账户即可启用的旅游活动API对接器
以下活动供应商已接入PHPTRAVELS旅游模块。您与供应商签约,在后台填入自己的凭据,并在上线前测试。名单来自我们集成目录的实时数据。
Tiqets现成对接器阅读集成指南
Tours BMS现成对接器
Viator现成对接器阅读集成指南- 全部集成
每个对接器能覆盖到哪一步,从搜索和详情到下单和电子票,取决于供应商以及它给您的账户类型,因此每份指南会说明各自的流程。如果供应商不在列表中,请参阅定制API集成。
旅行社延伸阅读:通过Viator联盟计划赚取收益和零投入在线销售旅游产品。
您自己的产品
API库存之外,也能销售您自己的行程
旅游活动API用其他公司的内容充实您的网站。您自己运营的行程,以及合作的本地运营商的行程,也应出现在同一个搜索里。
在PHPTRAVELS的旅游与活动中,您可以创建行程,设置行程安排、出发日期或场次、名额,以及按旅客类型的价格。它与供应商活动出现在同一结果页中,有自己的加价规则,旅客在同一个结账流程中预订。
- 您自己运营的行程您的行程您的出发日期、名额和价格,在您的后台管理。利润全部归您。
- 合作运营商本地运营商本地运营商登录后自行管理他们的行程、可订状态和价格;您再叠加自己的加价。
- 活动供应商供应商API来自已对接供应商的行程和门票,带实时库存和您的加价。
代理商可在B2B门户中以各自的价格预订这三类产品,并从钱包余额中付款。
旅游活动API是活动供应商提供的一组网络服务,让旅游网站可以搜索旅游团、活动和景点门票,查看日期与场次,获取按旅客类型的价格,创建预订并接收凭证。
这些说法指的是同一类东西。供应商会称之为旅游团、活动、体验或景点玩乐API,大多数在一个目录中涵盖导览团、一日游、体验项目和景点门票。
可以。Tiqets等景点门票供应商提供指定时段和不限日期的门票,含成人、儿童等票种,下单后会返回电子票。
需要。您要向每家供应商申请并获得自己的API密钥。您的账户能使用哪些产品、价格和预订权限,由供应商决定。PHPTRAVELS不提供供应商凭据。
实时库存下,供应商为每个日期或场次设置名额,API返回剩余数量。自由销售下,供应商不设固定配额,允许合作伙伴销售,并确认每笔预订,直到关闭该日期。
通常按旅客类型,年龄段由供应商为每个产品定义,如成人、儿童、婴儿和老人。包团行程和车辆往往按团队或按单位定价。您的加价叠加在其上。
旅游模块为Viator、Tiqets和Tours BMS等活动供应商提供现成的对接器。最新名单见集成目录,任何有API文档的供应商都可以作为自定义集成添加。
可以。您在PHPTRAVELS旅游模块中创建的行程,带有您自己的出发日期和价格,会与供应商活动出现在同一个搜索中,且各自有独立的加价。
可以,适用于企业版套餐。PHPTRAVELS REST API和Webhook附带文档,以统一格式开放已对接供应商的搜索与预订。
