createReservation
Start a ticket reservation. It’s possible to reserve multiple tickets in one call / reservation.
URL
https://globalreseller.nl/webservices/createReservation
HMAC calculation
apiKey + environment + ticketDate + ticketTime + tickets + userId
Please note: optional fields only needs to be included when an optional field is used.
Input:
| Name | Datatype | Description | ||||||
|---|---|---|---|---|---|---|---|---|
| apiKey | String | Your public apiKey needs to be included in every request. | ||||||
| environment | Enum | "test" or "production" | ||||||
| userId | Integer | The userId is a reference to the user (museum / attraction). The userId can be requested via getAvailableUsers and can be cached in your application. | ||||||
| tickets |
Array with the tickets
|
|||||||
| ticketDate | Date | The ticket date must comply with the yyyy-mm-dd format. | ||||||
| ticketTime | Time | (optional) 24 hours format (hh:mm), this field is optional based on the user. | ||||||
| HMACKey | String | The HMACKey is calculated based on the input fields. | ||||||
Output:
| Name | Datatype | Description |
|---|---|---|
| success | Boolean | Indicates if the request was successfully executed. |
| reservationId | Number | The transactionId needs to be included in further requests (addContact and completeReservation / cancelReservation). |
| reservationValidUntil | Datetime | Expiration datetime of the reservation. Format: yyyy-mm-dd hh:mm:ss |
JSON input example
{
"apiKey":"PUT-YOUR-PUBLIC-API-KEY-HERE",
"environment":"test",
"userId":1,
"tickets":[
{
"ticketTypeId":1001,
"ticketNumber":2
},
{
"ticketTypeId":1002,
"ticketNumber":1
}
],
"ticketDate":"2017-01-02",
"HMACKey":"PUT-YOUR-CALCULATED-HMAC-KEY-HERE"
}
JSON output example
{
"success":true,
"reservationId":687073,
"reservationValidUntil":"2018-11-16 21:06:14"
}