RowHint Seat Intelligence

Airline seat quality API. Scored seat data for 60+ aircraft configurations across 10 US airlines. Built for AI agents, travel apps, and booking tools.

原始信息汇总

RowHint Seat Intelligence API 数据集概述

数据集简介

RowHint Seat Intelligence 是一个提供航空公司座位质量数据的API。它弥补了传统航空公司座位图仅显示可用性而非乘坐体验的不足，提供了结构化、机器可读的座位数据。

核心功能

• 为每个座位提供1-10分的评分，并用颜色（绿色/黄色/红色）编码。
• 提供详细的座位标注，包括：窗户对齐情况（完整、减少或无）、倾斜限制、紧急出口和隔板位置、靠近厨房和洗手间的情况、座位下储物限制。
• 数据覆盖10家美国航空公司的40多种飞机配置，重点关注座位质量差异最大的经济舱和高端经济舱。
• 座位数据在航空公司特定的命名系统中进行了标准化，允许跨产品（如达美航空的“主舱”、美联航的“经济舱”和西南航空的标准座位）进行一致的筛选。
• 每个配置都包含指示其是否已完全验证或仍在处理中的元数据。
• 提供五个核心端点：按飞机配置的完整座位图、单个座位查询、舱内最佳和最差座位排名、无窗和窗户减少的座位识别、配置目录和覆盖范围元数据。

数据覆盖范围

• 航空公司：10家（美国航空、达美航空、美联航、西南航空、捷蓝航空、阿拉斯加航空、夏威夷航空、边疆航空、精神航空）。
• 配置：40多种（持续增加）。
• 飞机类型：包括波音737 MAX 8、空客A321neo、波音777-300ER、空客A350-900等多种型号。

API端点详情

1. 列出所有配置

• 端点：GET /configs
• 描述：返回可用飞机配置的完整目录，包括座位数、布局和直接链接。
• 用途：发现可用配置，获取其他端点的有效config_id值，构建航空公司/飞机选择用户界面。

2. 完整座位图

• 端点：GET /seats?config_id={config_id}
• 描述：返回飞机配置的完整座位数据：每个座位的评分和注释，按舱位组织，并包含设施位置。
• 关键返回字段：
  • id：座位标识符。
  • score：1-10的质量评分。
  • color：颜色编码。
  • flags：包含exit_row、bulkhead、near_galley、near_lavatory、limited_recline、no_underseat_storage、no_window等布尔标志的对象。

3. 单个座位查询

• 端点：GET /seat?config_id={config_id}&seat={seat_id}
• 描述：返回特定座位的评分、规格和标志。
• 用途：为聊天机器人提供“这个座位好吗？”查询，在预订前验证特定座位，或用座位质量上下文丰富预订确认。

4. 最佳和最差座位

• 端点：GET /seats/best?config_id={config_id}&cabin={cabin}&limit={n}&sort={direction}
• 描述：按评分返回排名座位，可选择舱位筛选。使用sort=best获取评分最高的座位，或sort=worst获取应避免的座位。
• 舱位筛选映射：
  • economy：匹配主舱、经济舱、标准经济舱等。
  • premium：匹配舒适经济舱、优选经济舱等。
  • business：匹配达美至臻商务舱、北极星商务舱等。
  • first：匹配头等舱。

5. 无窗座位

• 端点：GET /windowless?config_id={config_id}
• 描述：返回所有没有实际窗户的靠窗座位。
• 用途：在旅客为没有窗户的靠窗座位付费前发出警告，构建预订前警报，或填充“应避免座位”列表。

认证与调用

• 认证方式：在请求头中包含 RapidAPI 密钥。
  • X-RapidAPI-Key: your-api-key
  • X-RapidAPI-Host: rowhint-seat-intelligence.p.rapidapi.com
• 基础URL：https://rowhint.com/api/v1（通过RapidAPI调用时需替换为代理主机）。

数据状态说明

• 已验证配置：数据基于实时座位图验证。
• 预收入配置：代表尚未投入营收服务的飞机（例如，即将进行的客舱改装或新飞机交付），在响应中标记为"pre_revenue": true。数据基于航空公司公告和媒体报道，未经实时座位图验证。

错误响应

所有错误均遵循一致格式：{"error": "ERROR_CODE", "message": "Human-readable explanation."}。常见错误包括MISSING_CONFIG_ID、INVALID_SEAT、CONFIG_NOT_FOUND、SEAT_NOT_FOUND、RATE_LIMITED、INTERNAL_ERROR。

设计用途

该API专为集成到旅行产品而设计，包括需要以结构化、可编程方式呈现座位质量的预订工具、AI旅行助手和行程规划应用程序。