@findhotel/sapi 1.7.10-beta.0 → 1.7.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -32,7 +32,6 @@ hotels, hotels\' offers and rooms.
|
|
|
32
32
|
- [Filters](#filters)
|
|
33
33
|
- [Facilities](#facilities)
|
|
34
34
|
- [Property types](#property-types)
|
|
35
|
-
- [Amenities](#amenities)
|
|
36
35
|
- [Callbacks](#callbacks)
|
|
37
36
|
- [Response](#response-1)
|
|
38
37
|
- [Load more results and load more offers for a hotel](#load-more-results-and-load-more-offers-for-a-hotel)
|
|
@@ -482,7 +481,7 @@ split2: `checkIn: '2023-08-12'` `checkOut: '2023-08-15'`
|
|
|
482
481
|
<a id="search-filters"></a>
|
|
483
482
|
|
|
484
483
|
| name | type | description | example | filter scope |
|
|
485
|
-
|
|
484
|
+
|--------------------|------------|----------------------------------------------------------------------------------------------------|--------------------------------| ------------ |
|
|
486
485
|
| `themeIds` | `number[]` | Facet filtering by theme ids | `[1, 2, 3]` | Hotel |
|
|
487
486
|
| `chainIds` | `number[]` | Hotels' chain ids | `[4, 5]` | Hotel |
|
|
488
487
|
| `facilities` | `string[]` | Facility ids used for facet filtering | `[299,7,6,21]` | Hotel |
|
|
@@ -496,7 +495,7 @@ split2: `checkIn: '2023-08-12'` `checkOut: '2023-08-15'`
|
|
|
496
495
|
| `freeCancellation` | `boolean` | If true, only offers with free cancellation will be returned | `true` | Offer |
|
|
497
496
|
| `payLater` | `boolean` | If true, only offers with pay later option will be returned | `true` | Offer |
|
|
498
497
|
| `mealIncluded` | `boolean` | If true, only offers with meal included option will be returned | `true` | Offer |
|
|
499
|
-
| `amenities` | `string[]` | [Meal types](#filters-amenities)
|
|
498
|
+
| `amenities` | `string[]` | [Meal types](#filters-amenities) | `["breakfast","allInclusive"]` | |
|
|
500
499
|
| `isVr` | `boolean` | If true, then only vacation rentals are returned. If false, then vacation rentals are filtered out | `true` | Hotel |
|
|
501
500
|
|
|
502
501
|
##### Facilities
|
|
@@ -529,14 +528,14 @@ Some of the property types used for filtering:
|
|
|
529
528
|
<a id="filters-amenities"></a>
|
|
530
529
|
Supported amenities:
|
|
531
530
|
|
|
532
|
-
| name
|
|
533
|
-
|
|
|
534
|
-
| `breakfast`
|
|
535
|
-
| `lunch`
|
|
536
|
-
| `dinner`
|
|
537
|
-
| `halfBoard`
|
|
538
|
-
| `fullBoard`
|
|
539
|
-
| `allInclusive`
|
|
531
|
+
| name | description |
|
|
532
|
+
| ----------------- |--------------------------------------------------------------------------------------|
|
|
533
|
+
| `breakfast` | |
|
|
534
|
+
| `lunch` | |
|
|
535
|
+
| `dinner` | |
|
|
536
|
+
| `halfBoard` | "breakfast && dinner", or the hotel’s explicit use of the term "half-board" |
|
|
537
|
+
| `fullBoard` | "breakfast && lunch && dinner", or the hotel’s explicit use of the term "full-board" |
|
|
538
|
+
| `allInclusive` | "all meals && all drinks" or the hotel’s explicit use of the term "all-inclusive" |
|
|
540
539
|
|
|
541
540
|
|
|
542
541
|
### Callbacks
|
|
@@ -1148,27 +1147,26 @@ const offers = await sapiClient.offers(parameters, callbacks)
|
|
|
1148
1147
|
### Offers parameters
|
|
1149
1148
|
<a id="offers-parameters"></a>
|
|
1150
1149
|
|
|
1151
|
-
| name
|
|
1152
|
-
|
|
|
1153
|
-
| `hotelId`
|
|
1154
|
-
| `checkIn`
|
|
1155
|
-
| `checkOut`
|
|
1156
|
-
| `rooms`
|
|
1157
|
-
| `searchId`
|
|
1158
|
-
| `cugDeals`
|
|
1159
|
-
| `tier`
|
|
1160
|
-
| `freeCancellation`
|
|
1161
|
-
| `isAnchor`
|
|
1162
|
-
| `originId`
|
|
1163
|
-
| `label`
|
|
1164
|
-
| `preferredRate`
|
|
1165
|
-
| `metadata`
|
|
1166
|
-
| `filters`
|
|
1167
|
-
| `offersSort`
|
|
1168
|
-
| `getAllOffers`
|
|
1169
|
-
| `optimizeRooms`
|
|
1170
|
-
| `
|
|
1171
|
-
| `sbc` | `string` | [Split Booking Configuration](#splitbookingconfiguration). If present, searches for split booking offers | no | `sbc: '2~3'` |
|
|
1150
|
+
| name | type | description | required | example |
|
|
1151
|
+
| ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------ |
|
|
1152
|
+
| `hotelId` | `string` | Hotel Id | yes | `1196472` |
|
|
1153
|
+
| `checkIn` | `string` | Check in date (YYYY-MM-DD) (SDK generates default date if no provided) | no | `2022-10-10` |
|
|
1154
|
+
| `checkOut` | `string` | Check out date (YYYY-MM-DD)) (SDK generates default date if no provided) | no | `2022-10-11` |
|
|
1155
|
+
| `rooms` | `string` | [Rooms configuration](#rooms-configuration) | no | `2` |
|
|
1156
|
+
| `searchId` | `string` | SearchId override (SDK generates a new one if no provided) | no | `08230dfcc5f0fb95caaa82ce559ea60c4a975d6f` |
|
|
1157
|
+
| `cugDeals` | `string[]` | Codes of closed user group deals to retrieve offers | no | `['signed_in', 'offline']` |
|
|
1158
|
+
| `tier` | `string` | User tier | no | `member` |
|
|
1159
|
+
| `freeCancellation` | `boolean` | (Deprecated, use freeCancellation in the filters object instead) If true, only offers with free cancellation will be returned | no | `true` |
|
|
1160
|
+
| `isAnchor` | `boolean` | Anchor/Non anchor hotel (default `false`) | no | `true` |
|
|
1161
|
+
| `originId` | `string` | Identifier of origin where the request was originated | no | `c3po6twr70` |
|
|
1162
|
+
| `label` | `string` | Opaque value that will be passed to tracking systems | no | `gha-vr` |
|
|
1163
|
+
| `preferredRate` | `number` | Offer\'s price user saw on a CA (meta) platform | no | `196` |
|
|
1164
|
+
| `metadata` | `Record<string, string>` | Additional data to be passed to API | no | `{esd: 'abcds', epv: 'qwert'}` |
|
|
1165
|
+
| `filters` | `Object` | Object with [filters](#search-filters) | no | `{pay_later:true}` |
|
|
1166
|
+
| `offersSort` | `string` | If present, sorts offers by price (see [explanation](#sort-offers)) | no | |
|
|
1167
|
+
| `getAllOffers` | `boolean` | If `true` SAPI returns all (up to 23) offers for the hotel (by default or if it's `false` SAPI returns only up to 3 top offers) | no | |
|
|
1168
|
+
| `optimizeRooms` | `boolean` | If `true` then rooms optimization logic is enabled. Rooms optimization tries to find best offer across possible rooms configurations for a given occupancy | no | |
|
|
1169
|
+
| `sbc` | `string` | [Split Booking Configuration](#splitbookingconfiguration). If present, searches for split booking offers | no | `sbc: '2~3'` |
|
|
1172
1170
|
|
|
1173
1171
|
<a id="sort-offers"></a>
|
|
1174
1172
|
Offer sorting by one parameter for now. It is `price`, but there are different variants of sorting by price.:
|