Hoe kan ik de actuele bezetting op mijn website tonen (met een API)?

Wanneer je gebruik maakt van onze software kan je eenvoudig een reserveringsmodule op je website plaatsen (informatie in dit artikel), maar als je nog een stapje verder wilt integreren biedt onze API verdere mogelijkheden.

De API vind je in Beheer -> Integraties -> Custom API of REST API. Dit artikel beschrijft een Custom API, wat een (geheime) link is om de bezetting op te halen. Dit is voor veel locaties genoeg, als er meer wensen zijn kun je contact opnemen voor de REST API

Via deze link kan je real-time de actuele bezetting en prijzen ophalen. Je eigen web-bouwer kan vervolgens bepalen op welke plekken die gebruikt worden. Indien je de link opent krijg je de volgende JSON met informatie. Het is opgedeeld in 2 delen.

LIST:  Een opsomming van de toegevoegde plekken

"list": [
{
    "floor": 0,
    "volume": 12,
    "square": 4,
    "group": 1000, 
    "amount": 2,
    "available": 0
},
{
    "floor": 0,
    "volume": 15,
    "square": 5,
    "group": 1000,
    "amount": 1,
    "available": 1
},

// Group is een ID wat intern gebruikt wordt voor het cattegorisen van plekken. Group 1000 kan bijvoorbeeld zone A zijn en Group 1001 zone B

GROUP: Een opsomming van de toegevoegde prijzen. In theorie kan een plek meerdere prijzen hebben als je bijvoorbeeld een maandelijks en jaarlijks huren optie hebt. Het is niet zo de plek plek een prijs heeft, maar dat de locatie instelt alle 15 m3's hebben deze prijs. Je moet zelf deze matching doen.

    {
        "1000": [
        {
            "id": 2000,
            "package_name": "Basis",
            "type": "fixed",
            "price": 46800,
            "frequency": "month",
            "volume": 12,
            "square": "4",
            "floor": 0,
            "floor_until": null
        },
        {
            "id": 2001,
            "package_name": "Basis",
            "type": "fixed",
            "price": 46800,
            "frequency": "month",
            "volume": 15,
            "square": "5",
            "floor": 0,
            "floor_until": null
        },

// PACKAGE: De eigen toegevoegde naam van de prijsoptie
// ID: Uniek ID van de prijs

Vervolgens kan je dit soort elementen op je website dynamisch maken.

Het is wenselijk om de API maximaal 1x per uur op te halen en deze informatie zelf tijdelijk op te slaan, zodat de API niet bij elk bezoek opgehaald dient te worden.

Voor vragen kan de webbouwer ook contact opnemen met support@1stalling.nl.