feat: add date-based OHIP data reporting alongside XML

2026-09-18 15:29:27 +08:00
1 parent 5ecd571e3b
commit ad2c59256f
@@ -0,0 +1,144 @@
+{
+  "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"
+}