按已知邮轮 ID 与 SEO 名称获取邮轮详情

查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →

使用必填的 shipId 与 seoName 字符串获取邮轮详情,currencyCode 可选。文档指出邮轮搜索结果与邮轮快速链接是 shipId 和 seoName 的来源。应原样保留传入的 seoName,不要假定必须转成 URL 别名;文档示例为 MSC Magnifica,对应 shipId 15691635。USD 是文档给出的币种示例。该接口没有已保存的实测记录。截断的文档响应展示了 data.itineraries.list:条目包含 cruiseLine、destination、id、带 day 与 port 对象的 itinerary.results、length、lowestPricedSailing、portDeparture、sailings、ship 与 title。航次记录包含 departureDate、id 与 priceId,sailings 还包含 totalResults。这些都是未经核实的示例字段,既不完整,也不能保证实时返回。priceId 只是一个引用,不是文档中的金额;列出的出发日期也不能证明当前有可售名额。现有材料不能据此确定甲板平面图、舱房详情、预订动作或完整的邮轮档案响应。

API 功能

成对的邮轮引用查询 对已知邮轮同时使用必填的 shipId 与 seoName。契约指向邮轮搜索或快速链接记录作为这两个值的来源。
按天行程字段预览 未经核实的文档示例在 data.itineraries.list 中包含 itinerary.results 条目,条目带有 day 与 port 对象。
不含价格假设的航次标识 文档中的航次示例包含 departureDate、id 与 priceId,以及 sailings.totalResults。这些引用既不确定票价,也不确定当前可预订的出发日期。
邮轮公司与目的地上下文 示例把行程条目与 cruiseLine、destination、portDeparture、ship、title 字段关联起来,可用于潜在的内容展示布局,但仍需核实实际响应。

在线 API 演示

GET /api/project/tripadvisor-data/get-cruises-details

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-cruises-details?key=<API_KEY>&seoName=<seoName>&shipId=<shipId>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

请求邮轮详情需要哪些值?

shipId 与 seoName 都是必填字符串。文档指出邮轮搜索与邮轮快速链接记录是这两个值的来源。currencyCode 可选,可从货币查询结果中选择。

seoName 必须是带连字符的 URL 别名吗?

现有文档不要求做别名规范化。它的示例以 MSC Magnifica 作为 seoName,以 15691635 作为 shipId。应保留所选邮轮引用关联的原值,而不是自行发明规范化形式。

文档记录了哪些邮轮响应字段?

一份截断且未经核实的示例包含 data.itineraries.list,其中有邮轮公司、目的地、邮轮、出发港口、标题、时长与行程字段。itinerary.results 含 day 与 port 对象;航次记录含 departureDate、id 与 priceId,并带有 sailings.totalResults。这不是经过核实的完整结构。

priceId 是票价吗,航次记录能确认可售吗?

文档中的 priceId 字段并不能确定金额票价,应把它当作引用。同样,列出的出发日期或 lowestPricedSailing 对象也不能证明当前库存、有效报价或该航次可以预订。

甲板平面图、舱房或实时响应经过核实了吗?

没有已保存的实测记录覆盖本接口,且文档示例被截断。它不能确定甲板平面图或舱房详情。发布完整邮轮档案前应先核实实际返回结构;这个 GET 查询不会创建预订。

相关接口

相关指南

查看订阅方案 →