Op deze pagina staat beschreven hoe u toegang kunt krijgen tot de HolidayAgent API. Hiervoor is het genereren van een Access Token vanuit de website vereist.
Access Token
Een Access Token kan worden gegenereerd door een API-request uit te voeren:
https://api.holidayagent.nl/api/token/request?site=...&key=...
De waarden voor de parameters site
en key
ontvangt u van Holiday Media en zijn alleen voor de aangeleverde website beschikbaar. De API-key is een geheime sleutel en dient u veilig te bewaren.
Het resultaat van bovenstaand API-request geeft een response in JSON-formaat:
{
"response":{
"access_token":"********************************",
"time":1490276348,
"expires":43200
},
"status":"success",
"messages":{
"success":[],
"failure":[]
}
}
De volgende gegevens uit het response kunt u gebruiken om de widgets te verbinden met HolidayAgent:
response.access_token
: deze wordt ingevuld in het attribuut data-booking-token van de Basis Widget.response.time
: het tijdstip waarop het response gegenereerd is.response.expires
: dit is de TTL (time to live) in seconden, indien hier ‘-1’ staat, zal het Access Token niet vervallen.
Het wordt aangeraden om het Access Token, rekening houdend met de TTL, op te slaan op uw server. Dit voorkomt veel onnodige requests. Zodra het token verlopen is, kunt u via uw applicatie opnieuw een API-request uitvoeren om een nieuw token te genereren.
Onbeperkte geldigheid (standaard)
Wanneer u geen mogelijkheid heeft om serverside code uit te voeren op uw website, bieden we de mogelijkheid om een Access Token aan te leveren met een onbeperkte geldigheid. Dit doen we standaard tenzij anders gevraagd.