Productgroepen
==============

Huidige versie: 1.0.0

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

   Maak een nieuwe productgroep

   **Voorbeeld request**:

   .. sourcecode:: http

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

      {
         "naam": "Sport",
         "slug": "sport"
      }

   **Voorbeeld response**:

   .. sourcecode:: http

      HTTP/1.1 201 Created
      Content-Type: application/json
      Location: /api2/productgroepen/5

      {
         "id": 2,
         "naam": "Sport",
         "slug": "sport"
      }

   :json string naam: **Verplicht** Naam van de productgroep
   :json string slug: Unieke naam voor gebruik in tag, toegestane tekens zijn: kleine letters, cijfers, ``-`` (koppelteken) en ``_`` (laag streepje)

   :resheader Location: De locatie van de nieuwe productgroep

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

Read
----

Deze endpoints zijn publiek toegankelijk en vereisen geen authenticatie.


.. http:get:: /api2/productgroepen

   De productgroepen in Recras

   **Voorbeeld request**:

   .. sourcecode:: http

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

   **Voorbeeld response**:

   .. sourcecode:: http

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

      [
         {
            "id": 1,
            "naam": "Eten",
            "slug": "eten"
         }
      ]

   :statuscode 200: no error

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

   Een specifieke productgroep

   **Example request**:

   .. sourcecode:: http

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

   **Example response**:

   .. sourcecode:: http

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

      {
         "id": 1,
         "naam": "Eten",
         "slug": "eten"
      }

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

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

   **Voorbeeld request**:

   .. sourcecode:: http

      PUT /api2/productgroepen/2 HTTP/1.1
      Host: demo.recras.nl
      Accept: application/json

      {
         "id": 2
         "naam": "Sporten",
      }

   **Voorbeeld response**:

   .. sourcecode:: http

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

      {
         "id": 2,
         "naam": "Sporten",
         "slug": "sport"
      }

   :json int id: ID-nummer, mag niet veranderd worden
   :json string naam: Naam van de productgroep
   :json string slug: Unieke naam voor gebruik in tag, toegestane tekens zijn: kleine letters, cijfers, ``-`` (koppelteken) en ``_`` (laag streepje)

   :statuscode 200: Productgroep aangepast
   :statuscode 406: Fout in de invoer
   :statuscode 403: Gebruiker heeft het recht ``editProducten`` niet

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

   **Voorbeeld request**:

   .. sourcecode:: http

      DELETE /api2/productgroepen/2 HTTP/1.1
      Host: demo.recras.nl

   **Voorbeeld response**:

   .. sourcecode:: http

      HTTP/1.1 200 OK

   :statuscode 200: Productgroep verwijderd
   :statuscode 403: Gebruiker heeft het recht ``editProducten`` niet