{
  "version": "arr-api-research-requests/v1",
  "status": "research-templates-with-live-followup-not-production-equivalence",
  "service_url": "https://ohip.nianxx.cn",
  "context": "OHIPSB02 known test context; date is illustrative, no records asserted",
  "authentication": "X-API-Key loaded privately from ARR application credential; no key embedded",
  "examples": [
    {
      "id": "date_baseline",
      "purpose": "建立日期候选集合；未证明等价 ALL，未添加 ETA/状态/分房/代码子集限制",
      "operation_id": "searchHotelReservations",
      "method": "POST",
      "path": "/api/v1/reservations/searches",
      "body": {
        "arrivalStartDate": "2026-09-15",
        "arrivalEndDate": "2026-09-15",
        "limit": 2,
        "offset": 0,
        "orderBy": [
          "ConfirmationNo"
        ],
        "sortOrder": [
          "Asc"
        ]
      }
    },
    {
      "id": "explicit_status_probe",
      "purpose": "与基线逐类比较；所有状态枚举不是已确认的报表 ALL",
      "operation_id": "searchHotelReservations",
      "method": "POST",
      "path": "/api/v1/reservations/searches",
      "body": {
        "arrivalStartDate": "2026-09-15",
        "arrivalEndDate": "2026-09-15",
        "limit": 2,
        "offset": 0,
        "orderBy": [
          "ConfirmationNo"
        ],
        "sortOrder": [
          "Asc"
        ],
        "reservationStatuses": [
          "Cancelled",
          "CheckedOut",
          "CheckedIn",
          "DueIn",
          "DueOut",
          "InHouse",
          "NoShow",
          "WaitList"
        ]
      }
    },
    {
      "id": "eta_minute_boundary_probe",
      "purpose": "测试23:59:00结束边界及空ETA；+07:00仅按项目Asia/Bangkok背景举例",
      "operation_id": "searchHotelReservations",
      "method": "POST",
      "path": "/api/v1/reservations/searches",
      "body": {
        "arrivalStartDate": "2026-09-15",
        "arrivalEndDate": "2026-09-15",
        "limit": 2,
        "offset": 0,
        "orderBy": [
          "ConfirmationNo"
        ],
        "sortOrder": [
          "Asc"
        ],
        "expectedArrivalStartTime": "2026-09-15T00:00:00+07:00",
        "expectedArrivalEndTime": "2026-09-15T23:59:00+07:00"
      }
    },
    {
      "id": "eta_last_second_probe",
      "purpose": "与23:59:00请求比较；此边界也未认定为报表语义",
      "operation_id": "searchHotelReservations",
      "method": "POST",
      "path": "/api/v1/reservations/searches",
      "body": {
        "arrivalStartDate": "2026-09-15",
        "arrivalEndDate": "2026-09-15",
        "limit": 2,
        "offset": 0,
        "orderBy": [
          "ConfirmationNo"
        ],
        "sortOrder": [
          "Asc"
        ],
        "expectedArrivalStartTime": "2026-09-15T00:00:00+07:00",
        "expectedArrivalEndTime": "2026-09-15T23:59:59+07:00"
      }
    },
    {
      "id": "detail_fields_probe",
      "purpose": "用搜索返回的内部Reservation身份替换占位符；逐笔校验hotel/identity和所需块",
      "operation_id": "getReservation",
      "method": "GET",
      "path": "/api/v1/reservations/{reservationID}",
      "path_parameters": {
        "reservationID": "<internal-reservation-id-from-search>"
      },
      "query_parameters": [
        [
          "fetchInstructions",
          "Reservation"
        ],
        [
          "fetchInstructions",
          "Comments"
        ],
        [
          "fetchInstructions",
          "Traces"
        ],
        [
          "fetchInstructions",
          "DailySummary"
        ],
        [
          "fetchInstructions",
          "RateInfoDetails"
        ],
        [
          "fetchInstructions",
          "Packages"
        ],
        [
          "fetchInstructions",
          "InventoryItems"
        ],
        [
          "fetchInstructions",
          "Shares"
        ]
      ]
    }
  ],
  "live_followup": "arr-api-probe-results-20260916.json; actual requests privately archived; ETA with +07:00 returned zero and is not approved"
}