API - Troubleshooting

Gewijzigd op Di, 16 Sep om 3:47 PM

Ervaar je problemen bij het gebruik van de API van Studytube? In dit artikel helpen we je op weg met de meest voorkomende foutmeldingen en tips om deze zelfstandig op te lossen.

1. Geen response of time-out

Mogelijke oorzaken:

De API-endpoint is incorrect of bestaat niet.
Er is een tijdelijke netwerkonderbreking of serververtraging.
De API-call duurt te lang en overschrijdt de time-outlimiet van je systeem.

Wat kun je doen:

Controleer of je het juiste endpoint gebruikt.
Herhaal de aanvraag na enkele minuten.
Verklein het aantal resultaten per request (bijv. met limit=50) om de verwerkingstijd te verkorten.

2. Foutcode 401 – Unauthorized

Betekenis: De API-verzoek bevat geen geldige authenticatie.

Controleer:

Of je een geldige Bearer token meestuurt in de Authorization-header.
Of de token nog actief is (tokens kunnen verlopen).
Of de API-key rechten heeft voor de opgevraagde resource.

Oplossing:

Vraag indien nodig een nieuwe token aan via Studytube of de gekoppelde authenticatiedienst.

3. Foutcode 403 – Forbidden

Betekenis: Je hebt geen rechten om de opgevraagde resource te benaderen.

Mogelijke oorzaken:

De API-key is geldig, maar mist specifieke toegangsrechten.
Je probeert toegang te krijgen tot data buiten je organisatie (bijv. van een andere tenant).

Wat kun je doen:

Controleer met je technisch beheerder welke rechten aan je API-key zijn toegekend.
Neem contact op met service@studytube.nl als je denkt dat je toegang zou moeten hebben.

4. Foutcode 404 – Not Found

Betekenis: Het opgevraagde endpoint of object bestaat niet.

Oorzaken:

De URL is verkeerd gespeld of bevat een foutief ID.
Het object (bijv. gebruiker, cursus) is verwijderd of nooit aangemaakt.

Oplossing:

Controleer de documentatie van de API om te zien of het endpoint klopt.
Verifieer het ID dat je gebruikt.

5. Foutcode 422 – Unprocessable Entity

Betekenis: De server begrijpt het verzoek, maar kan het niet verwerken vanwege ongeldige of ontbrekende gegevens.

Veelvoorkomende fouten:

Verplichte velden zijn leeg of niet correct geformatteerd.
Er wordt een niet-bestaande referentie gebruikt (bijv. team-ID of cursus-ID).

Oplossing:

Controleer of alle vereiste velden correct zijn ingevuld.
Bekijk de response-body voor een gedetailleerde foutmelding.

6. Foutcode 500 – Internal Server Error

Betekenis: Er is iets misgegaan aan de kant van de server.

Wat kun je doen:

Probeer de aanvraag opnieuw na enkele minuten.
Neem contact op met service@studytube.nl als de fout zich blijft voordoen.
Voeg indien mogelijk een request ID of logregel toe bij je melding.

Hulp nodig?

Kom je er niet uit of zie je een foutmelding die hier niet tussen staat? Neem dan contact op via service@studytube.nl

en stuur daarbij:

Het gebruikte endpoint
De volledige foutmelding (inclusief statuscode en response-body)
Eventuele headers of payloads (bij voorkeur geanonimiseerd)