Locaties
========

Huidige versie: 1.0.0

Create
------
.. http:post:: /api2/locaties

   Maak een nieuwe locatie aan

   **Voorbeeld request**

   .. sourcecode:: http

      POST /api2/locaties HTTP/1.1
      Host: demo.recras.nl
      Accept: application/json

      {
         "naam": "kleine zaal",
         "weergavenaam": "vergaderzaal (tot 15 p.)",
         "capaciteit": 20,
         "aantal_groepen": 1
      }

   **Voorbeeld response**

   .. sourcecode:: http

      HTTP/1.1 201 Created
      Content-Type: application/json
      Location: /api2/locaties/12

      {
         "id": 12,
         "naam": "kleine zaal",
         "kleur": null,
         "weergavenaam": "vergaderzaal (tot 15 p.)",
         "adres": null,
         "postcode": null,
         "plaats": null,
         "telefoonnummer": null,
         "latitude": null,
         "longitude": null,
         "capaciteit": 20,
         "aantal_groepen": 1,
         "parent_id": null
      }

   :json string naam: **Verplicht** Naam van de locatie
   :json string kleur: Default: ``null`` Kleur voor in dagplanning
   :json string weergavenaam: Default: ``null`` Naam die naar klanten wordt weergegeven
   :json string adres: Default: ``null`` Adres van de locatie
   :json string postcode: Default: ``null`` Postcode van de locatie
   :json string plaats: Default: ``null`` Plaats van de locatie
   :json string telefoonnummer: Default: ``null`` Telefoonnummer van de locatie
   :json float latitude: Default: ``null`` GPS-breedtegraad van de locatie (decimaal)
   :json float longitude: Default: ``null`` GPS-lengtegraad van de locatie (decimaal)
   :json integer capaciteit: Default: ``null`` Aantal personen dat maximaal tegelijk aanwezig kan zijn
   :json integer capaciteit: Default: ``null`` Aantal boekingen dat maximaal tegelijk plaats kan vinden
   :json integer parent_id: Default: ``null`` De ``id`` van de locatie waar deze locatie deel van is

   :resheader Location: De http-locatie van de nieuwe locatie

   :statuscode 201: Locatie gemaakt
   :statuscode 406: Fout in de invoer
   :statuscode 403: Gebruiker heeft het recht ``editLocaties`` niet

Read
----
.. http:get:: /api2/locaties

   Lijst van locaties in Recras

   **Voorbeeld request**:

   .. sourcecode:: http

      GET /api2/locaties HTTP/1.1
      Host: demo.recras.nl
      Accept: application/json

   **Voorbeeld response**:

   .. sourcecode:: http

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

      [
         {
            "id": 5,
            "naam": "Paintball",
            "kleur": "#e6ead1",
            "weergavenaam": "Paintball",
            "adres": "",
            "postcode": "",
            "plaats": "",
            "telefoonnummer": "",
            "latitude": null,
            "longitude": null,
            "capaciteit": 40,
            "aantal_groepen": 2,
            "parent_id": null
         },
         {
            "id": 9,
            "naam": "Paintball \"het Bos\"",
            "kleur": "#23d421",
            "weergavenaam": "Paintball \"het Bos\"",
            "adres": "",
            "postcode": "",
            "plaats": "",
            "telefoonnummer": "",
            "latitude": null,
            "longitude": null,
            "capaciteit": 15,
            "aantal_groepen": 1,
            "parent_id": 5
         }
      ]

   :query treeContains: Een kommagescheiden lijst van locatie-ids, geeft alle locaties die een van de opgegeven ids in de boomstructuur bevatten.
   :query embedGebruikOpDatum: Een datum waarvoor de gebruiksinformatie (hoeveel personen en groepen zijn er van moment tot moment) getoond moet worden

   :statuscode 200: OK

.. http:get:: /api2/locaties/(int:id)

   Een specifieke betaalmethode

   :query embedGebruikOpDatum: Een datum waarvoor de gebruiksinformatie (hoeveel personen en groepen zijn er van moment tot moment) getoond moet worden

   :statuscode 200: OK
   :statuscode 404: Geen locatie met deze ``id``

Update
------
.. http:put:: /api2/locaties/(int:id)

   Zie :http:post:`/api2/locaties`

Delete
------
.. http:delete:: /api2/locaties/(int:id)

   **Voorbeeld request**:

   .. sourcecode:: http

      DELETE /api2/locaties/1 HTTP/1.1
      Host: demo.recras.nl

   **Voorbeeld response**:

   .. sourcecode:: http

      HTTP/1.1 200 OK

   :statuscode 200: Locatie verwijderd
   :statuscode 403: Gebruiker heeft het recht ``editLocaties`` niet