Fejl

Fejlresponser

Fenerum API'et bruger standard HTTP-svarkoder til at angive, om en API-anmodning lykkes eller fejler.

HTTP-statuskoder

  • 2xx - Succes: Anmodningen blev udført med succes
  • 4xx - Klientfejl: Der var en fejl i anmodningen (f.eks. manglende parametre, autentificeringsfejl)
  • 5xx - Serverfejl: Noget gik galt på Fenerums servere

Almindelige statuskoder

Status CodeMeaning
200OK - Anmodning lykkedes
201Created - Ressource blev oprettet
204No Content - Anmodning lykkedes uden svarkrop
400Bad Request - Ugyldige anmodningsparametre
401Unauthorized - Autentificering mislykkedes eller mangler
403Forbidden - Autentificeret, men ikke autoriseret
404Not Found - Ressource findes ikke
429Too Many Requests - Rate limit overskredet
500Internal Server Error - Noget gik galt hos os

Format for fejlrespons

Når der opstår en fejl, returnerer API'et et JSON-objekt med detaljer:

{
  "detail": "Error description",
  "field_name": ["Specific field error messages"]
}

Feltspecifikke fejl

Ved valideringsfejl indeholder svaret feltspecifikke fejlmeddelelser:

{
  "email": ["This field is required."],
  "amount": ["Ensure this value is greater than or equal to 0."]
}

Bedste praksis

  • Kontrollér altid HTTP-statuskoden, før svaret parses
  • Log fejlresponser til fejlfinding
  • Håndter rate limiting-fejl med eksponentiel backoff
  • Vis brugervenlige beskeder for valideringsfejl
background logo

Vi fakturerer for mere end 2 millarder årligt for vores kunder. Skal vi hjælpe dig med at sætte din fakturering på autopilot?