Productgroepen

Huidige versie: 1.0.0

Create

POST /api2/productgroepen

Maak een nieuwe productgroep

Voorbeeld request:

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

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

Voorbeeld response:

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

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

JSON Parameters:

• naam (string) – Verplicht Naam van de productgroep

• slug (string) – Unieke naam voor gebruik in tag, toegestane tekens zijn: kleine letters, cijfers, - (koppelteken) en _ (laag streepje)

Response Headers:

• Location – De locatie van de nieuwe productgroep

Status Codes:

• 201 Created – Productgroep gemaakt

• 406 Not Acceptable – Fout in de invoer

• 403 Forbidden – Gebruiker heeft het recht editProducten niet

Read

Deze endpoints zijn publiek toegankelijk en vereisen geen authenticatie.

GET /api2/productgroepen

De productgroepen in Recras

Voorbeeld request:

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

Voorbeeld response:

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

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

Status Codes:

• 200 OK – no error

GET /api2/productgroepen/(int: id)

Een specifieke productgroep

Example request:

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

Example response:

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

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

Status Codes:

• 200 OK – OK

• 404 Not Found – Geen productgroep met deze id

Update

PUT /api2/productgroepen/(int: id)

Voorbeeld request:

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

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

Voorbeeld response:

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

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

JSON Parameters:

• id (int) – ID-nummer, mag niet veranderd worden

• naam (string) – Naam van de productgroep

• slug (string) – Unieke naam voor gebruik in tag, toegestane tekens zijn: kleine letters, cijfers, - (koppelteken) en _ (laag streepje)

Status Codes:

• 200 OK – Productgroep aangepast

• 406 Not Acceptable – Fout in de invoer

• 403 Forbidden – Gebruiker heeft het recht editProducten niet

Delete

DELETE /api2/productgroepen/(int: id)

Voorbeeld request:

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

Voorbeeld response:

HTTP/1.1 200 OK

Status Codes:

• 200 OK – Productgroep verwijderd

• 403 Forbidden – Gebruiker heeft het recht editProducten niet