.. _product_availability:

Producten-Beschikbaarheid
=========================

Huidige versie: 1.0.0

Read
----
.. http: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 date eind: **Verplicht** een ISO8601-datum die het eind van de datumreeks aangeeft. De opgegeven datum valt binnen het bereik.
   :query date begin: Default: _vandaag_ een ISO8601-datum die het begin van de gewenste datumreeks aangeeft. De opgegeven datum valt buiten het bereik.
   :query boolean cache: Options: `force_on`, `force_off`. Default: `force_on`. Override de standaard-instelling voor gebruikscache in Recras.

   :statuscode 200: OK
   :statuscode 400: Fout in de parameters

   :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**:

   .. sourcecode:: http

      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**:

   .. sourcecode:: http

      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 string startmoment: ISO8601 startmoment van product
   :json array locaties: Lijst van locaties waar het product kan plaatsvinden met bijbehorende beschikbaarheid
   :json int locaties.locatie_id: id van locatie, `null` wordt ook toegevoegd indien dit product ook zonder locatie geboekt mag worden
   :json int locaties.beschikbaarheid: De beschikbaarheid van het product op dit startmoment en locatie. 99999 wordt gebruikt als waarde voor onbeperkte capaciteit.