4.7 KiB
4.7 KiB
ARR 接口研究方向纠正
2026-09-16。用户明确纠正：提供Opera操作要素，是要求理解业务条件后在平台找到对应接口， 不是记录页面步骤后用模拟点击下载报告。此前推进计划报表/SFTP并要求用户反复配合页面，是Agent偏离任务。
当前约束
- 回到平台catalog/OpenAPI与Oracle字段契约研究，输出业务要素→Operation ID→参数/返回字段→缺口的映射。
- 停止浏览器点击下载、Schedule Report/SFTP验证分支，不再要求用户打开页面或补截图来推进这条分支。
- XML是已提供的人工样本格式和既有处理器入口，不是用户确认的“只有原生XML下载API才可推进”技术限制。
- 原生报表API未发现，不等于平台预订API无法覆盖ARR数据需求；应评估预订搜索和详情组合。
- 组合接口是否完整等价仍须验证；本次纠正不等于已经批准重建XML、修改处理器、绕过独立校验或提交Finance。
- 酒店/测试环境背景、独立应用凭据、固定价格规则和完整日提交语义继续沿用。
- 用户随后允许多个子智能体，但每轮需先询问并获许可。本轮提出两个只读分工、收到“允许本轮启用两个”后启动；不构成未来或嵌套授权。
重新核对的真实平台操作
2026-09-16T07:07:21Z，CLI分别回读两个操作定义，退出0、ok=true、HTTP200、目录版本0.6.0：
| Operation ID | Edge路径 | 用途及证据边界 |
|---|---|---|
| searchHotelReservations | POST /api/v1/reservations/searches | 按条件分页查预订；平台透传Oracle请求体，非query参数搜索 |
| getReservation | GET /api/v1/reservations/{reservationID} | 读取单笔详情；平台允许fetchInstructions查询参数，用于按Oracle契约获取备注等资料 |
两者属于已授予的reservations.read，没有因这次核对更改权限。仅调用开发目录，不调用酒店业务数据。
请求ID分别为 a9df12e3-83cc-42c4-a797-688467f7c708、e70955dc-8d7f-4064-a307-c18103e5da6f。
完整无秘密目录响应保存于 /Users/chillishark/Downloads/arr-api-mapping-y6mh_nlo/（目录0700、JSON0600）。
研究应围绕这些对应关系继续
| 用户要素 | 当前接口/字段依据 | 尚需核实 |
|---|---|---|
| T-1到店日 | searchHotelReservations请求体arrivalStartDate / arrivalEndDate | 自然日/酒店时区；不可换成营业日或住宿统计日 |
| ALL Reservations | reservationStatuses、actualArrivals、expectedArrivals、dayOfArrivalCancels | 组合及默认行为是否覆盖原报表全部状态；不能只取当前在住 |
| ALL Room Assignment | roomAssignedOnly / roomUnassignedOnly | 不施加单侧限制的准确调用方式和返回全集 |
| 各项ALL CODES | 不增加对应业务子集筛选；取得完整集后走现有白名单 | 各字段默认值和服务限制，不能把ALL当成未经定义的字面参数 |
| 00:00–23:59 | expectedArrivalStartTime / expectedArrivalEndTime为酒店时区date-time | 空ETA、分钟末尾、带星显示时间及实际/预计到店语义 |
| 显示Room Number | 搜索/详情中的roomStay房间字段 | 分配状态、共享/多房、字段与XML的对应关系 |
| Notes及Resv. - GEN | getReservation的Comments；comment.type/notificationLocation/text | 后续测试实际type=GEN/location=RESERVATION，与官方例子反向；正式酒店及CAS/GENERAL对应待验证 |
| Include Internal Notes | comment.internal，保留所选备注范围内的内外部记录 | 返回完整性与权限；不等于仅选internal=true或改用confidential |
| 公司、房价、Trace等处理字段 | getReservation的公司关联、roomRates、Traces等 | 角色、生效日期、过滤和稳定顺序，沿用接口研究中的缺口 |
| 手工Download As XML | 现有样本/处理入口格式 | 平台若返回JSON，讨论可重放适配契约；不能假设已有完整XML下载能力 |
Oracle字段来自已验证固定提交的rsv.json；存在字段不代表业务语义已证明。正式实现前须完成 完整分页/详情采集、原始响应保存、同环境样本比对及适配方式讨论，不把一次请求成功当作全流程验收。
下一步交付应是可讨论的接口组合、请求构造、字段映射和未覆盖项，而不是更多UI点击要求或SFTP配置。
本轮后续已交付详细接口对应表和离线检查后的请求示例，见核对证据。
随后已按用户“继续”完成单日API只读联调，确认139笔详情可获取，新增实际筛选和金额缺口；未改变本页API方向约束。