Producten-Beschikbaarheid

Huidige versie: 1.0.0

Read

GET /api2/producten/(int: product_id)/beschikbaarheid

Verkrijg een lijst van startmomenten en beschikbaarheden per mogelijke locatie voor het product met id product_id. Alleen beschikbaar voor producten met de instelling mag_api = true

Query Parameters:

  • eind (date) – Verplicht een ISO8601-datum die het eind van de datumreeks aangeeft. De opgegeven datum valt binnen het bereik.

  • begin (date) – Default: _vandaag_ een ISO8601-datum die het begin van de gewenste datumreeks aangeeft. De opgegeven datum valt buiten het bereik.

  • cache (boolean) – Options: force_on, force_off. Default: force_on. Override de standaard-instelling voor gebruikscache in Recras.

Status Codes:
Header Link:

Wanneer een gedeeltelijk resultaat wordt teruggegeven, is een Link-header met link-relatie next aanwezig. Deze bevat een URI die wijst naar het volgende (deel)resultaat. Het is mogelijk dat het volgende deelresultaat enkele resultaten bevat die eerder ook al teruggegeven zijn.

Voorbeeld request:

GET /api2/producten/7/beschikbaarheid?begin=2037-04-01&eind=2037-04-02 HTTP/1.1
Host: demo.recras.nl
Accept: application/json

Voorbeeld response:

HTTP/1.1 200 OK
Content-Type: application/json

[
   {
      "startmoment":"2037-04-01T16:00:00+02:00",
      "locaties":[
         {
            "locatie_id":null,
            "beschikbaarheid":99999
         },
         {
            "locatie_id":1,
            "beschikbaarheid":16
         },
         {
            "locatie_id":2,
            "beschikbaarheid":99999
         },
         {
            "locatie_id":3,
            "beschikbaarheid":99999
         }
      ]
   },
   {
      "startmoment":"2037-04-01T17:00:00+02:00",
      "locaties":[
         {
            "locatie_id":null,
            "beschikbaarheid":99999
         },
         {
            "locatie_id":1,
            "beschikbaarheid":16
         },
         {
            "locatie_id":2,
            "beschikbaarheid":99999
         },
         {
            "locatie_id":3,
            "beschikbaarheid":99999
         }
      ]
   }
]
JSON Parameters:

  • startmoment (string) – ISO8601 startmoment van product

  • locaties (array) – Lijst van locaties waar het product kan plaatsvinden met bijbehorende beschikbaarheid

  • locaties.locatie_id (int) – id van locatie, null wordt ook toegevoegd indien dit product ook zonder locatie geboekt mag worden

  • locaties.beschikbaarheid (int) – De beschikbaarheid van het product op dit startmoment en locatie. 99999 wordt gebruikt als waarde voor onbeperkte capaciteit.