Back to Collection Items
#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;
// Use this online tool to generate code from sample JSON: Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "reservations": {
// "reservation": [
// {
// "sourceOfSale": {
// "sourceType": "PMS",
// "sourceCode": "{{HotelId}}"
// },
// "roomStay": {
// "roomRates": [
// {
// "total": {
// "amountBeforeTax": "200"
// },
// "rates": {
// "rate": [
// {
// "base": {
// "amountBeforeTax": "200",
// "currencyCode": "USD"
// },
// "shareDistributionInstruction": "Full",
// "total": {
// "amountBeforeTax": "200"
// },
// "start": "{{currentdate}}",
// "end": "{{currentdateplus1}}"
// }
// ]
// },
// "guestCounts": {
// "adults": "1",
// "children": "0"
// },
// "roomType": "{{RoomTypeCode}}",
// "ratePlanCode": "{{RatePlanCode}}",
// "start": "{{currentdate}}",
// "end": "{{currentdateplus1}}",
// "suppressRate": true,
// "marketCode": "LEISURE",
// "marketCodeDescription": "Leisure",
// "sourceCode": "PHONE",
// "sourceCodeDescription": "Over the Phone",
// "numberOfUnits": "1",
// "pseudoRoom": false,
// "roomTypeCharged": "{{RoomTypeCode}}",
// "houseUseOnly": false,
// "complimentary": false,
// "fixedRate": true,
// "discountAllowed": false,
// "bogoDiscount": false
// }
// ],
// "guestCounts": {
// "adults": "1",
// "children": "0"
// },
// "arrivalDate": "{{currentdate}}",
// "departureDate": "{{currentdateplus1}}",
// "guarantee": {
// "guaranteeCode": "6PM",
// "shortDescription": "6PM Hold"
// },
// "roomNumberLocked": false,
// "printRate": false
// },
// "reservationGuests": [
// {
// "profileInfo": {
// "profile": {
// "customer": {
// "personName": [
// {
// "givenName": "Jane",
// "surname": "Smith",
// "nameType": "Primary"
// },
// {
// "nameType": "External"
// }
// ],
// "language": "E"
// },
// "profileType": "Guest"
// }
// },
// "primary": true
// }
// ],
// "reservationPaymentMethods": [
// {
// "paymentMethod": "CA",
// "folioView": "1"
// }
// ],
// "comments": [
// {
// "comment": {
// "text": {
// "value": "Please ensure I have tea in my room"
// },
// "commentTitle": "General Notes",
// "notificationLocation": "RESERVATION",
// "type": "GEN",
// "internal": false
// }
// }
// ],
// "hotelId": "{{HotelId}}",
// "roomStayReservation": true,
// "reservationStatus": "Reserved",
// "computedReservationStatus": "DueIn",
// "walkIn": false,
// "printRate": false,
// "preRegistered": false,
// "upgradeEligible": false,
// "allowAutoCheckin": false,
// "hasOpenFolio": false,
// "allowMobileCheckout": false,
// "allowMobileViewFolio": false,
// "allowPreRegistration": false,
// "optedForCommunication": false
// }
// ]
// }
// }
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"reservations.reservation[0].sourceOfSale.sourceType" value: @"PMS"];
[json UpdateString: @"reservations.reservation[0].sourceOfSale.sourceCode" value: @"{{HotelId}}"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].total.amountBeforeTax" value: @"200"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].base.amountBeforeTax" value: @"200"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].base.currencyCode" value: @"USD"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].shareDistributionInstruction" value: @"Full"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].total.amountBeforeTax" value: @"200"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].start" value: @"{{currentdate}}"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].end" value: @"{{currentdateplus1}}"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].guestCounts.adults" value: @"1"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].guestCounts.children" value: @"0"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].roomType" value: @"{{RoomTypeCode}}"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].ratePlanCode" value: @"{{RatePlanCode}}"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].start" value: @"{{currentdate}}"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].end" value: @"{{currentdateplus1}}"];
[json UpdateBool: @"reservations.reservation[0].roomStay.roomRates[0].suppressRate" value: YES];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].marketCode" value: @"LEISURE"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].marketCodeDescription" value: @"Leisure"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].sourceCode" value: @"PHONE"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].sourceCodeDescription" value: @"Over the Phone"];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].numberOfUnits" value: @"1"];
[json UpdateBool: @"reservations.reservation[0].roomStay.roomRates[0].pseudoRoom" value: NO];
[json UpdateString: @"reservations.reservation[0].roomStay.roomRates[0].roomTypeCharged" value: @"{{RoomTypeCode}}"];
[json UpdateBool: @"reservations.reservation[0].roomStay.roomRates[0].houseUseOnly" value: NO];
[json UpdateBool: @"reservations.reservation[0].roomStay.roomRates[0].complimentary" value: NO];
[json UpdateBool: @"reservations.reservation[0].roomStay.roomRates[0].fixedRate" value: YES];
[json UpdateBool: @"reservations.reservation[0].roomStay.roomRates[0].discountAllowed" value: NO];
[json UpdateBool: @"reservations.reservation[0].roomStay.roomRates[0].bogoDiscount" value: NO];
[json UpdateString: @"reservations.reservation[0].roomStay.guestCounts.adults" value: @"1"];
[json UpdateString: @"reservations.reservation[0].roomStay.guestCounts.children" value: @"0"];
[json UpdateString: @"reservations.reservation[0].roomStay.arrivalDate" value: @"{{currentdate}}"];
[json UpdateString: @"reservations.reservation[0].roomStay.departureDate" value: @"{{currentdateplus1}}"];
[json UpdateString: @"reservations.reservation[0].roomStay.guarantee.guaranteeCode" value: @"6PM"];
[json UpdateString: @"reservations.reservation[0].roomStay.guarantee.shortDescription" value: @"6PM Hold"];
[json UpdateBool: @"reservations.reservation[0].roomStay.roomNumberLocked" value: NO];
[json UpdateBool: @"reservations.reservation[0].roomStay.printRate" value: NO];
[json UpdateString: @"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.personName[0].givenName" value: @"Jane"];
[json UpdateString: @"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.personName[0].surname" value: @"Smith"];
[json UpdateString: @"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.personName[0].nameType" value: @"Primary"];
[json UpdateString: @"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.personName[1].nameType" value: @"External"];
[json UpdateString: @"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.language" value: @"E"];
[json UpdateString: @"reservations.reservation[0].reservationGuests[0].profileInfo.profile.profileType" value: @"Guest"];
[json UpdateBool: @"reservations.reservation[0].reservationGuests[0].primary" value: YES];
[json UpdateString: @"reservations.reservation[0].reservationPaymentMethods[0].paymentMethod" value: @"CA"];
[json UpdateString: @"reservations.reservation[0].reservationPaymentMethods[0].folioView" value: @"1"];
[json UpdateString: @"reservations.reservation[0].comments[0].comment.text.value" value: @"Please ensure I have tea in my room"];
[json UpdateString: @"reservations.reservation[0].comments[0].comment.commentTitle" value: @"General Notes"];
[json UpdateString: @"reservations.reservation[0].comments[0].comment.notificationLocation" value: @"RESERVATION"];
[json UpdateString: @"reservations.reservation[0].comments[0].comment.type" value: @"GEN"];
[json UpdateBool: @"reservations.reservation[0].comments[0].comment.internal" value: NO];
[json UpdateString: @"reservations.reservation[0].hotelId" value: @"{{HotelId}}"];
[json UpdateBool: @"reservations.reservation[0].roomStayReservation" value: YES];
[json UpdateString: @"reservations.reservation[0].reservationStatus" value: @"Reserved"];
[json UpdateString: @"reservations.reservation[0].computedReservationStatus" value: @"DueIn"];
[json UpdateBool: @"reservations.reservation[0].walkIn" value: NO];
[json UpdateBool: @"reservations.reservation[0].printRate" value: NO];
[json UpdateBool: @"reservations.reservation[0].preRegistered" value: NO];
[json UpdateBool: @"reservations.reservation[0].upgradeEligible" value: NO];
[json UpdateBool: @"reservations.reservation[0].allowAutoCheckin" value: NO];
[json UpdateBool: @"reservations.reservation[0].hasOpenFolio" value: NO];
[json UpdateBool: @"reservations.reservation[0].allowMobileCheckout" value: NO];
[json UpdateBool: @"reservations.reservation[0].allowMobileViewFolio" value: NO];
[json UpdateBool: @"reservations.reservation[0].allowPreRegistration" value: NO];
[json UpdateBool: @"reservations.reservation[0].optedForCommunication" value: NO];
[http SetRequestHeader: @"Content-Type" value: @"application/json"];
[http SetRequestHeader: @"x-hotelid" value: @"{{HotelId}}"];
// Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken = @"<access_token>";
[http SetRequestHeader: @"x-app-key" value: @"{{AppKey}}"];
CkoHttpResponse *resp = [http PostJson3: @"https://domain.com/rsv/v1/hotels/{{HotelId}}/reservations/" contentType: @"application/json" json: json];
if (http.LastMethodSuccess == NO) {
NSLog(@"%@",http.LastErrorText);
return;
}
NSLog(@"%d",[resp.StatusCode intValue]);
NSLog(@"%@",resp.BodyStr);
Curl Command
curl -X POST
-H "Authorization: Bearer <access_token>"
-H "Content-Type: application/json"
-H "x-hotelid: {{HotelId}}"
-H "x-app-key: {{AppKey}}"
-d '{
"reservations": {
"reservation": [
{
"sourceOfSale": {
"sourceType": "PMS",
"sourceCode": "{{HotelId}}"
},
"roomStay": {
"roomRates": [
{
"total": {
"amountBeforeTax": "200"
},
"rates": {
"rate": [
{
"base": {
"amountBeforeTax": "200",
"currencyCode": "USD"
},
"shareDistributionInstruction": "Full",
"total": {
"amountBeforeTax": "200"
},
"start": "{{currentdate}}",
"end": "{{currentdateplus1}}"
}
]
},
"guestCounts": {
"adults": "1",
"children": "0"
},
"roomType": "{{RoomTypeCode}}",
"ratePlanCode": "{{RatePlanCode}}",
"start": "{{currentdate}}",
"end": "{{currentdateplus1}}",
"suppressRate": true,
"marketCode": "LEISURE",
"marketCodeDescription": "Leisure",
"sourceCode": "PHONE",
"sourceCodeDescription": "Over the Phone",
"numberOfUnits": "1",
"pseudoRoom": false,
"roomTypeCharged": "{{RoomTypeCode}}",
"houseUseOnly": false,
"complimentary": false,
"fixedRate": true,
"discountAllowed": false,
"bogoDiscount": false
}
],
"guestCounts": {
"adults": "1",
"children": "0"
},
"arrivalDate": "{{currentdate}}",
"departureDate": "{{currentdateplus1}}",
"guarantee": {
"guaranteeCode": "6PM",
"shortDescription": "6PM Hold"
},
"roomNumberLocked": false,
"printRate": false
},
"reservationGuests": [
{
"profileInfo": {
"profile": {
"customer": {
"personName": [
{
"givenName": "Jane",
"surname": "Smith",
"nameType": "Primary"
},
{
"nameType": "External"
}
],
"language": "E"
},
"profileType": "Guest"
}
},
"primary": true
}
],
"reservationPaymentMethods": [
{
"paymentMethod": "CA",
"folioView": "1"
}
],
"comments": [
{
"comment": {
"text": {
"value": "Please ensure I have tea in my room"
},
"commentTitle": "General Notes",
"notificationLocation": "RESERVATION",
"type": "GEN",
"internal": false
}
}
],
"hotelId": "{{HotelId}}",
"roomStayReservation": true,
"reservationStatus": "Reserved",
"computedReservationStatus": "DueIn",
"walkIn": false,
"printRate": false,
"preRegistered": false,
"upgradeEligible": false,
"allowAutoCheckin": false,
"hasOpenFolio": false,
"allowMobileCheckout": false,
"allowMobileViewFolio": false,
"allowPreRegistration": false,
"optedForCommunication": false
}
]
}
}'
https://domain.com/rsv/v1/hotels/{{HotelId}}/reservations/
Postman Collection Item JSON
{
"name": "Create a new reservation",
"event": [
{
"listen": "test",
"script": {
"exec": [
"var data = pm.response.headers.get(\"Location\").split(\"/\").pop();\r",
"postman.setEnvironmentVariable(\"ReservationId\", data);"
],
"type": "text/javascript"
}
}
],
"request": {
"auth": {
"type": "bearer",
"bearer": [
{
"key": "token",
"value": "{{Token}}",
"type": "string"
}
]
},
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-hotelid",
"type": "text",
"value": "{{HotelId}}"
},
{
"key": "x-app-key",
"value": "{{AppKey}}",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"reservations\": {\r\n \"reservation\": [\r\n {\r\n \"sourceOfSale\": {\r\n \"sourceType\": \"PMS\",\r\n \"sourceCode\": \"{{HotelId}}\"\r\n },\r\n \"roomStay\": {\r\n \"roomRates\": [\r\n {\r\n \"total\": {\r\n \"amountBeforeTax\": \"200\"\r\n },\r\n \"rates\": {\r\n \"rate\": [\r\n {\r\n \"base\": {\r\n \"amountBeforeTax\": \"200\",\r\n \"currencyCode\": \"USD\"\r\n },\r\n \"shareDistributionInstruction\": \"Full\",\r\n \"total\": {\r\n \"amountBeforeTax\": \"200\"\r\n },\r\n \"start\": \"{{currentdate}}\",\r\n \"end\": \"{{currentdateplus1}}\"\r\n }\r\n ]\r\n },\r\n \"guestCounts\": {\r\n \"adults\": \"1\",\r\n \"children\": \"0\"\r\n },\r\n \"roomType\": \"{{RoomTypeCode}}\",\r\n \"ratePlanCode\": \"{{RatePlanCode}}\",\r\n \"start\": \"{{currentdate}}\",\r\n \"end\": \"{{currentdateplus1}}\",\r\n \"suppressRate\": true,\r\n \"marketCode\": \"LEISURE\",\r\n \"marketCodeDescription\": \"Leisure\",\r\n \"sourceCode\": \"PHONE\",\r\n \"sourceCodeDescription\": \"Over the Phone\",\r\n \"numberOfUnits\": \"1\",\r\n \"pseudoRoom\": false,\r\n \"roomTypeCharged\": \"{{RoomTypeCode}}\",\r\n \"houseUseOnly\": false,\r\n \"complimentary\": false,\r\n \"fixedRate\": true,\r\n \"discountAllowed\": false,\r\n \"bogoDiscount\": false\r\n }\r\n ],\r\n \"guestCounts\": {\r\n \"adults\": \"1\",\r\n \"children\": \"0\"\r\n },\r\n \"arrivalDate\": \"{{currentdate}}\",\r\n \"departureDate\": \"{{currentdateplus1}}\",\r\n \"guarantee\": {\r\n \"guaranteeCode\": \"6PM\",\r\n \"shortDescription\": \"6PM Hold\"\r\n },\r\n \"roomNumberLocked\": false,\r\n \"printRate\": false\r\n },\r\n \"reservationGuests\": [\r\n {\r\n \"profileInfo\": {\r\n \"profile\": {\r\n \"customer\": {\r\n \"personName\": [\r\n {\r\n \"givenName\": \"Jane\",\r\n \"surname\": \"Smith\",\r\n \"nameType\": \"Primary\"\r\n },\r\n {\r\n \"nameType\": \"External\"\r\n }\r\n ],\r\n \"language\": \"E\"\r\n },\r\n \"profileType\": \"Guest\"\r\n }\r\n },\r\n \"primary\": true\r\n }\r\n ],\r\n \"reservationPaymentMethods\": [\r\n {\r\n \"paymentMethod\": \"CA\",\r\n \"folioView\": \"1\"\r\n }\r\n ],\r\n \"comments\": [\r\n {\r\n \"comment\": {\r\n \"text\": {\r\n \"value\": \"Please ensure I have tea in my room\"\r\n },\r\n \"commentTitle\": \"General Notes\",\r\n \"notificationLocation\": \"RESERVATION\",\r\n \"type\": \"GEN\",\r\n \"internal\": false\r\n }\r\n }\r\n ],\r\n \"hotelId\": \"{{HotelId}}\",\r\n \"roomStayReservation\": true,\r\n \"reservationStatus\": \"Reserved\",\r\n \"computedReservationStatus\": \"DueIn\",\r\n \"walkIn\": false,\r\n \"printRate\": false,\r\n \"preRegistered\": false,\r\n \"upgradeEligible\": false,\r\n \"allowAutoCheckin\": false,\r\n \"hasOpenFolio\": false,\r\n \"allowMobileCheckout\": false,\r\n \"allowMobileViewFolio\": false,\r\n \"allowPreRegistration\": false,\r\n \"optedForCommunication\": false\r\n }\r\n ]\r\n }\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{HostName}}/rsv/v1/hotels/{{HotelId}}/reservations/",
"host": [
"{{HostName}}"
],
"path": [
"rsv",
"v1",
"hotels",
"{{HotelId}}",
"reservations",
""
]
}
},
"response": [
]
}