按已知邮轮 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 组合丰富一篇邮轮介绍页面,并在查看真实响应后再挑选展示字段。
- 在目录维护时核对已保存的邮轮引用,而不是把这次详情查询当作能发现全部可售邮轮的数据源。
- 按文档中的 itinerary.results 结构原型化按天港口行程视图,并明确标注该示例结构尚未核实。
- 设计邮轮出发引用模型,把航次 ID 与 priceId 同金额价格、预订可用性分开存储。
常见问题
请求邮轮详情需要哪些值?
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 查询不会创建预订。