CruiseWave API

Sail into seamless cruise planning with CruiseWave API, offering real-time search and booking options for cruises worldwide. Simplify integration with intuitive endpoints that provide itineraries, cabin details, pricing, and exclusive offers, all in one place. Perfect for travel platforms and cruise enthusiasts alike!

原始信息汇总

CruiseWave API 数据集概述

基本信息

• API名称: CruiseWave API
• 当前版本: 2.0.0
• 类别: Travel
• API概述: 提供实时游轮数据访问的接口，用于豪华游轮和旅行规划。

主要功能

• 综合游轮搜索: 支持按目的地、日期、出发港口、游轮公司和预算搜索。
• 详细行程: 提供每日行程、港口访问和活动信息。
• 舱位与价格信息: 显示舱位可用性、类型和相关价格。
• 预订集成: 支持直接预订或保留所选游轮。
• 实时更新: 获取可用性、价格和独家优惠的最新数据。
• 丰富元数据: 包含游轮公司描述、船上设施、娱乐选项和餐饮亮点。

适用场景

• 旅行社: 集成以扩展游轮选项并提供个性化旅行套餐。
• 游轮公司聚合平台: 整合多家游轮公司数据至统一平台。
• 开发者: 构建游轮规划应用或将搜索和预订功能集成到现有旅行解决方案。
• 旅游网站: 添加游轮预订小部件或定制推荐以提高用户参与度和转化率。

端点详情

搜索操作

• 端点: GET /v2/cruise-search
• 功能: 通过灵活筛选搜索可用游轮。
• 必需参数:
  • departure_port: 港口代码（例如 "MIA", "TPA", "SYD"）。
  • destination: 目的地代码（例如 "CARIB", "ALASKA", "EUROPE"）。
  • start_date: 开始日期（YYYY-MM-DD）。
  • end_date: 结束日期（YYYY-MM-DD）。
• 可选参数:
  • country: 国家代码（默认: "USA"）。
  • currency: 货币代码（默认: "USD"）。

元数据操作

• 端点: GET /v2/metadata/ports
  • 功能: 获取所有可用出发港口（缓存24小时）。
• 端点: GET /v2/metadata/destinations
  • 功能: 获取所有可用目的地区域（缓存24小时）。
• 端点: GET /v2/metadata 或 GET /v2/metadata/filters
  • 功能: 在单个请求中获取港口和目的地（缓存24小时）。

健康与监控

• 端点: GET /v2/ping
  • 功能: 健康检查端点，用于验证API可用性。

港口代码参考（部分示例）

美国港口（15个）

代码	港口名称	城市，州
MIA	PortMiami	Miami, Florida
TPA	Port Tampa Bay	Tampa, Florida
FLL	Port Everglades	Fort Lauderdale, Florida

国际港口

区域	代码	港口名称	地点
澳大利亚及太平洋	SYD	Sydney Harbour	Sydney, Australia
欧洲	BCN	Port of Barcelona	Barcelona, Spain
亚洲	SIN	Marina Bay Cruise Centre	Singapore

目的地代码（部分示例）

代码	目的地	描述
CARIB	Caribbean	包括东、西和南加勒比海的所有加勒比岛屿
BAHAMAS	Bahamas	巴哈马群岛
ALASKA	Alaska	包括内湾航道和冰川湾的阿拉斯加游轮
EUROPE	Europe	包括地中海和北欧的所有欧洲目的地

性能与缓存

• 元数据端点: 缓存24小时（86400秒）。
• 搜索结果: 实时数据，始终最新。
• 响应时间:
  • 元数据: ~200毫秒（缓存）。
  • 搜索: ~2-5秒（实时数据）。

响应格式

• 所有响应均采用一致的JSON结构。
• 包含用于调试的请求ID（X-Request-ID标头）。
• 包含带有有用详细信息的清晰错误消息。
• 使用ISO 8601时间戳。

订阅计划

• BASIC: $0.00 / 月
• PRO: $0.00 / ---
• ULTRA: $10.00 / 月
• MEGA: $40.00 / 月

搜集汇总

背景与挑战

背景概述

CruiseWave API为全球邮轮行程提供实时搜索和预订服务，集成行程安排、舱位详情、价格及专属优惠等数据接口，助力旅游平台开发和邮轮爱好者规划。