Sobes.tech
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

  1. 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.
  1. Serviceparameters voor authenticatie en autorisatie:
  • Header Authorization: Bearer <token> — toegangstoken van de gebruiker.
  • Mogelijk extra headers of cookies als er een sessie wordt gebruikt.
  1. 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]
}
  1. 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.