Middle
Voor de endpoint POST /api/tasks (taak aanmaken): 1) Welke invoerparameters zijn vereist? 2) Welke serviceparameters voor authenticatie en autorisatie? 3) Geef een voorbeeld van een geldige JSON-verzoek met een array van tag_ids. 4) Welke HTTP-statuscodes zou je gebruiken?
sobes.tech AI
Antwoord van AI
- Invoergegevens voor POST /api/tasks:
title(string) — naam van de taak, verplicht.description(string) — beschrijving van de taak, optioneel.due_date(string, ISO 8601 formaat) — vervaldatum, optioneel.priority(string of int) — prioriteit van de taak, optioneel.tag_ids(array van int) — identificaties van tags gerelateerd aan de taak, optioneel.
- Serviceparameters voor authenticatie en autorisatie:
- Header
Authorization: Bearer <token>— toegangstoken van de gebruiker. - Mogelijk extra headers of cookies als er een sessie wordt gebruikt.
- Voorbeeld van geldige JSON-verzoek:
{
"title": "Rapport maken",
"description": "Verkooprapport voor de maand voorbereiden",
"due_date": "2024-07-01T18:00:00Z",
"priority": "high",
"tag_ids": [12, 34, 56]
}
- HTTP-statuscodes van de reactie:
201 Created— taak succesvol aangemaakt.400 Bad Request— onjuist formaat of ontbrekende verplichte velden.401 Unauthorized— ontbreekt of ongeldig authenticatietoken.403 Forbidden— gebruiker heeft geen rechten om de taak te maken.500 Internal Server Error— interne serverfout.
Deze set statussen dekt de belangrijkste scenario's voor interactie met de API.