Foutcodes en probleemoplossing

Gestandaardiseerde HTTP-foutstructuur, overzicht van codes en aanbevelingen.

Wanneer een verzoek niet verwerkt kan worden, retourneert SmallPict een HTTP-statuscode met een duidelijk JSON-foutobject voor snelle analyse.

JSON-foutstructuur

JSON

{  "success": false,  "error": {    "code": "INVALID_IMAGE_PAYLOAD",    "message": "Het aangeleverde bestand is geen geldige afbeelding of is beschadigd.",    "details": {      "mime_type": "text/html",      "expected": [        "image/jpeg",        "image/png",        "image/webp",        "image/avif"      ]    }  }}

Overzicht van HTTP-foutcodes

Code	Foutidentificatie	Oorzaak	Oplossing
`400`	`BAD_REQUEST`	Ongeldig JSON-formaat of onjuiste parameters.	Controleer de JSON-opmaak en parameternamen.
`401`	`UNAUTHORIZED`	API-sleutel ontbreekt of is ingetrokken.	Controleer de header `X-API-Key`.
`401`	`TIMESTAMP_DRIFT`	Tijdstempel wijkt meer dan ±300 seconden af.	Synchroniseer de servertijd via NTP.
`401`	`INVALID_SIGNATURE`	Berekende handtekening komt niet overeen.	Controleer de canonieke string en de secret key.
`403`	`FORBIDDEN`	Sleutel heeft onvoldoende rechten voor de actie.	Pas de rechten van de sleutel aan in het dashboard.
`404`	`NOT_FOUND`	De taak (`job_id`) of het bestand bestaat niet.	Controleer de identifier in de URL.
`413`	`PAYLOAD_TOO_LARGE`	Bestand overschrijdt de maximale bestandsgrootte van uw abonnement.	Verklein of comprimeer het bestand vooraf.
`415`	`UNSUPPORTED_MEDIA`	Bestandstype wordt niet ondersteund.	Verstuur alleen JPEG, PNG, WebP, AVIF of SVG.
`422`	`UNPROCESSABLE`	Geldige extensie, maar binaire data is beschadigd.	Controleer of het bestand compleet is geüpload.
`429`	`RATE_LIMIT_EXCEEDED`	Te veel verzoeken per seconde.	Bouw herhaalpogingen in met exponentiële wachttijd.
`429`	`QUOTA_EXCEEDED`	Maandquotum voor transformaties is verbruikt.	Upgrade uw abonnement via het dashboard.
`500`	`INTERNAL_ERROR`	Onverwachte fout in de verwerkingsservers.	Probeer het verzoek na een kort moment opnieuw.
`503`	`SERVICE_UNAVAILABLE`	Gepland onderhoud of piekbelasting.	Schakel tijdelijk over naar passthrough-modus.