|
1 | 1 | { |
2 | 2 | "swagger": "2.0", |
| 3 | + "x-sap-shortText": "Hotel workflow endpoints.", |
3 | 4 | "tags": [ |
4 | 5 | { |
5 | 6 | "description": "Hotel workflow endpoints", |
6 | | - "name": "service" |
| 7 | + "name": "Service" |
| 8 | + } |
| 9 | + ], |
| 10 | + "x-servers": [ |
| 11 | + { |
| 12 | + "url": "https://www.concursolutions.com/api/v4.0", |
| 13 | + "description": "Concur API EndPoint" |
7 | 14 | } |
8 | 15 | ], |
9 | 16 | "basePath": "/", |
10 | 17 | "host": "hs-mock.service.cnqr.tech", |
11 | 18 | "info": { |
12 | | - "contact": { |
13 | | - "name": "SAP Concur Developer Center", |
14 | | - "url": "https://developer.concur.com/api-explorer/v4-0/HotelService.swagger2.json" |
15 | | - }, |
16 | | - "description": "## Important: Please refer to [Endpoints](https://developer.concur.com/api-reference/direct-connects/hotel-service-4/v4.endpoints.html) document for detailed documentation on all endpoints for this API.\nHotelService API provides a method for Custom Hotel Source vendors to provide hotel inventory, rates and booking related functionality to users of Concur OBT (Online Booking Tool).", |
17 | | - "title": "HotelService API", |
| 19 | + "description": "## Important: Please refer to [Endpoints](https://developer.concur.com/api-reference/direct-connects/hotel-service-4/v4.endpoints.html) document for detailed documentation on all endpoints for this API.\nHotel Service API provides a method for Custom Hotel Source vendors to provide hotel inventory, rates and booking related functionality to users of Concur OBT (Online Booking Tool).", |
| 20 | + "title": "Hotel Service API", |
18 | 21 | "version": "4.0" |
19 | 22 | }, |
20 | 23 | "paths": { |
|
30 | 33 | "in": "header", |
31 | 34 | "name": "Accept-Language", |
32 | 35 | "required": false, |
33 | | - "type": "string" |
| 36 | + "type": "string", |
| 37 | + "description": "Advertises which languages the client is able to understand" |
34 | 38 | }, |
35 | 39 | { |
36 | 40 | "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.", |
|
77 | 81 | }, |
78 | 82 | "summary": "Retrieve descriptive details about specified hotels.", |
79 | 83 | "tags": [ |
80 | | - "service" |
| 84 | + "Service" |
81 | 85 | ] |
82 | 86 | } |
83 | 87 | }, |
|
93 | 97 | "in": "header", |
94 | 98 | "name": "Accept-Language", |
95 | 99 | "required": false, |
96 | | - "type": "string" |
| 100 | + "type": "string", |
| 101 | + "description": "Advertises which languages the client is able to understand" |
97 | 102 | }, |
98 | 103 | { |
99 | 104 | "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.", |
|
140 | 145 | }, |
141 | 146 | "summary": "Retrieve hotel rate details", |
142 | 147 | "tags": [ |
143 | | - "service" |
| 148 | + "Service" |
144 | 149 | ] |
145 | 150 | } |
146 | 151 | }, |
|
156 | 161 | "in": "header", |
157 | 162 | "name": "Accept-Language", |
158 | 163 | "required": false, |
159 | | - "type": "string" |
| 164 | + "type": "string", |
| 165 | + "description": "Advertises which languages the client is able to understand" |
160 | 166 | }, |
161 | 167 | { |
162 | 168 | "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.", |
|
203 | 209 | }, |
204 | 210 | "summary": "Retrieve rates for specific hotel properties", |
205 | 211 | "tags": [ |
206 | | - "service" |
| 212 | + "Service" |
207 | 213 | ] |
208 | 214 | } |
209 | 215 | }, |
|
219 | 225 | "in": "header", |
220 | 226 | "name": "Accept-Language", |
221 | 227 | "required": false, |
222 | | - "type": "string" |
| 228 | + "type": "string", |
| 229 | + "description": "Advertises which languages the client is able to understand" |
223 | 230 | }, |
224 | 231 | { |
225 | 232 | "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.", |
|
266 | 273 | }, |
267 | 274 | "summary": "Reserve the given hotel rate", |
268 | 275 | "tags": [ |
269 | | - "service" |
| 276 | + "Service" |
270 | 277 | ] |
271 | 278 | } |
272 | 279 | }, |
|
275 | 282 | "consumes": [ |
276 | 283 | "application/json" |
277 | 284 | ], |
278 | | - "description": "Cancel specified reservation", |
| 285 | + "description": "Cancel specified reservation according to parameters", |
279 | 286 | "operationId": "cancel", |
280 | 287 | "parameters": [ |
281 | 288 | { |
282 | 289 | "in": "header", |
283 | 290 | "name": "Accept-Language", |
284 | 291 | "required": false, |
285 | | - "type": "string" |
| 292 | + "type": "string", |
| 293 | + "description": "Advertises which languages the client is able to understand" |
286 | 294 | }, |
287 | 295 | { |
288 | 296 | "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.", |
|
332 | 340 | }, |
333 | 341 | "summary": "Cancel specified reservation", |
334 | 342 | "tags": [ |
335 | | - "service" |
| 343 | + "Service" |
336 | 344 | ] |
337 | 345 | } |
338 | 346 | }, |
|
348 | 356 | "in": "header", |
349 | 357 | "name": "Accept-Language", |
350 | 358 | "required": false, |
351 | | - "type": "string" |
| 359 | + "type": "string", |
| 360 | + "description": "Advertises which languages the client is able to understand" |
352 | 361 | }, |
353 | 362 | { |
354 | 363 | "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.", |
|
401 | 410 | }, |
402 | 411 | "summary": "Modify specific reservation", |
403 | 412 | "tags": [ |
404 | | - "service" |
| 413 | + "Service" |
405 | 414 | ] |
406 | 415 | } |
407 | 416 | }, |
|
417 | 426 | "in": "header", |
418 | 427 | "name": "Accept-Language", |
419 | 428 | "required": false, |
420 | | - "type": "string" |
| 429 | + "type": "string", |
| 430 | + "description": "Advertises which languages the client is able to understand" |
421 | 431 | }, |
422 | 432 | { |
423 | 433 | "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.", |
|
467 | 477 | }, |
468 | 478 | "summary": "Returns detailed information about a hotel reservation.", |
469 | 479 | "tags": [ |
470 | | - "service" |
| 480 | + "Service" |
471 | 481 | ] |
472 | 482 | } |
473 | 483 | }, |
|
476 | 486 | "consumes": [ |
477 | 487 | "application/json" |
478 | 488 | ], |
479 | | - "description": "Perform the initial search for hotels.", |
| 489 | + "description": "Perform the initial search for hotels according to params", |
480 | 490 | "operationId": "search", |
481 | 491 | "parameters": [ |
482 | 492 | { |
483 | 493 | "in": "header", |
484 | 494 | "name": "Accept-Language", |
485 | 495 | "required": false, |
486 | | - "type": "string" |
| 496 | + "type": "string", |
| 497 | + "description": "Advertises which languages the client is able to understand" |
487 | 498 | }, |
488 | 499 | { |
489 | 500 | "in": "header", |
490 | 501 | "name": "concur-correlationid", |
491 | 502 | "required": true, |
492 | | - "type": "string" |
| 503 | + "type": "string", |
| 504 | + "description": "Correlation ID to track the record across the logs" |
493 | 505 | }, |
494 | 506 | { |
495 | 507 | "description": "Hotel search criteria", |
|
529 | 541 | }, |
530 | 542 | "summary": "Perform the initial search for hotels.", |
531 | 543 | "tags": [ |
532 | | - "service" |
| 544 | + "Service" |
533 | 545 | ] |
534 | 546 | } |
535 | 547 | } |
|
2170 | 2182 | "SABRE", |
2171 | 2183 | "AMADEUS", |
2172 | 2184 | "TRAVELPORT" |
2173 | | - ], |
| 2185 | + ] |
2174 | 2186 | }, |
2175 | 2187 | "pcc": { |
2176 | 2188 | "description": "Pseudo City Code or Office ID (OID) for the GDS account to be used for this booking (active or passive segment).", |
|
2679 | 2691 | }, |
2680 | 2692 | "categories": { |
2681 | 2693 | "type": "array", |
2682 | | - "$ref": "#/definitions/SafetyScoreCategory" |
| 2694 | + "items": { |
| 2695 | + "$ref": "#/definitions/SafetyScoreCategory" |
| 2696 | + } |
2683 | 2697 | } |
2684 | 2698 | }, |
2685 | 2699 | "required": [ |
|
2692 | 2706 | "description": "Safety score category classification of the hotel", |
2693 | 2707 | "properties": { |
2694 | 2708 | "type": { |
2695 | | - "type": "enum", |
| 2709 | + "type": "string", |
2696 | 2710 | "enum": [ "NIGHTTIME_SAFETY", "PHYSICAL_SAFETY", "BASIC_FREEDOMS", "WOMENS_SAFETY", "THEFT", "HEALTH_AND_MEDICAL", "LGBTQ_PLUS_SAFETY"] |
2697 | 2711 | }, |
2698 | 2712 | "score": { |
2699 | 2713 | "type": "number" |
2700 | 2714 | } |
2701 | 2715 | }, |
2702 | 2716 | "required": [ |
2703 | | - "category", |
| 2717 | + "type", |
2704 | 2718 | "score" |
2705 | 2719 | ], |
2706 | 2720 | "type": "object" |
|
0 commit comments