Référence
Codes d'erreur
Format et codes HTTP retournés par l'API
L'API retourne des codes HTTP standards avec un corps au format problem+json (RFC 7807).
Format Error
{
"type": "...",
"title": "...",
"status": 400,
"detail": "Explication détaillée",
"instance": "/properties?..."
}Champs (via le schéma Error de l'OpenAPI) :
| Champ | Type | Description |
|---|---|---|
type | string | URI identifiant le type d'erreur |
title | string | null | Résumé court |
status | number | Code HTTP |
detail | string | null | Description détaillée |
instance | string | null | URI de la requête fautive |
422 Validation (ConstraintViolation)
Pour les erreurs de validation, le corps contient aussi un tableau violations :
{
"type": "/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "...",
"violations": [
{ "propertyPath": "price.gte", "message": "must be positive" }
]
}Codes documentés par endpoint
Les endpoints de l'OpenAPI exposent les codes suivants selon le contexte :
| Code | Usage |
|---|---|
200 | Succès (lecture) |
201 | Ressource créée |
204 | Succès sans contenu (DELETE) |
400 | Requête invalide (paramètre mal formé) |
403 | Accès refusé |
404 | Ressource introuvable |
422 | Échec de validation — voir violations |