Foutcodes

Begrijpen van API-foutresponsen en hoe ze te behandelen.

Overzicht

De API retourneert gestandaardiseerde foutresponsen met specifieke foutcodes om u te helpen problemen te identificeren en op te lossen.

Foutresponsformaat

Alle foutresponsen volgen deze structuur:

{
  "status": "error",
  "error": {
    "code": "AUTH_1001",
    "message": "Ontbrekende authenticatiegegevens",
    "details": "Velden 'username' en 'password' zijn beide vereist",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

Authenticatiefouten (1000-1099)

Fouten gerelateerd aan inloggegevens en authenticatie.

Code	HTTP	Bericht	Oplossing
`AUTH_1001`	401	Ontbrekende authenticatiegegevens	Voeg gebruikersnaam en wachtwoord toe aan verzoek
`AUTH_1002`	401	Ongeldige gebruikersnaam of wachtwoord	Controleer of inloggegevens correct zijn
`AUTH_1003`	403	Account tijdelijk vergrendeld	Wacht voor opnieuw proberen of neem contact op met support

Quotafouten (1100-1199)

Fouten gerelateerd aan API-quota en gebruikslimieten.

Code	HTTP	Bericht	Oplossing
`QUOTA_1101`	403	Onvoldoende API-quota	Koop meer credits of controleer quota
`QUOTA_1102`	429	API-quota overschreden	Wacht op quota-vernieuwing of upgrade plan

Validatiefouten (2000-2099)

Fouten gerelateerd aan verzoekvalidatie en invoergegevens.

Code	HTTP	Bericht	Oplossing
`VAL_2001`	400	Geen bestand geüpload	Voeg bestand toe aan verzoek
`VAL_2002`	400	Ongeldig bestandsformaat	Gebruik ondersteunde formaten: PDF, PNG, JPG, WEBP
`VAL_2003`	400	Meerdere PDF-bestanden niet toegestaan	Upload één PDF of meerdere afbeeldingen
`VAL_2004`	400	PDF en afbeeldingen kunnen niet worden gemengd	Upload PDF of afbeeldingen, niet beide
`VAL_2005`	400	Niet-ondersteunde taalcode	Gebruik ondersteunde taalcode

Verwerkingsfouten (3000-3099)

Fouten tijdens documentverwerking en AI-analyse.

Code	HTTP	Bericht	Oplossing
`PROC_3001`	500	Documentverwerking mislukt	Controleer afbeeldingskwaliteit, probeer opnieuw
`PROC_3002`	500	Metadata-extractie mislukt	Zorg ervoor dat document leesbare tekst bevat
`PROC_3003`	500	Parameter-extractie mislukt	Controleer of bloedtest formaat herkenbaar is
`PROC_3006`	504	Verwerkingstimeout overschreden	Verklein bestandsgrootte of verdeel in meerdere verzoeken

Serverfouten (5000-5099)

Interne serverfouten en beschikbaarheidsproblemen.

Code	HTTP	Bericht	Oplossing
`SRV_5001`	500	Interne serverfout	Probeer opnieuw, neem contact op met support als probleem aanhoudt
`SRV_5002`	503	Service tijdelijk niet beschikbaar	Wacht en probeer opnieuw met exponentiële back-off

Beste Praktijken voor Foutafhandeling

Aanbevelingen

Controleer altijd het status veld - Succesvolle responsen hebben "status": "success"
Implementeer herhaalpogingen voor tijdelijke fouten (5xx) met exponentiële back-off
Log foutcodes voor debugging en monitoring
Toon gebruiksvriendelijke berichten op basis van foutcodes
Gebruik sandbox endpoints om foutafhandeling te testen