-
Notifications
You must be signed in to change notification settings - Fork 152
Error handling Example with multiple errors
HTTP/1.1 400
{
"type": "https://api.demo.nbb.be/v1/errors/validation",
"title": "Validation errors",
"titleKey": "errors.validation",
"errors": [
{
"type": "https://api.demo.nbb.be/v1/errors/validation-user-invalid",
"title": "Invalid user information",
"titleKey": "errors.validation.user.invalid",
"detail": "The start date must be before the end date",
"detailKey": "errors.validation.user.invalid.start.date.after.end.date",
"fields": [
"start-date",
"end-date"
],
"identifier": "9335d74d-2649-4eec-a272-ab2803e25a40"
},
{
"type": "https://api.demo.nbb.be/v1/errors/validations-user-invalid",
"title": "Invalid user information",
"titleKey": "errors.validation.user.invalid",
"detail": "The username is already in use",
"detailKey": "errors.validation.user.invalid.username.already.in.use",
"fields": [
"username"
],
"identifier": "b9b41a65-28ed-4736-ab05-9d4defdcdd23"
}
]
}
Notice in the example above that each error provides a specific identifier. This is not mandatory but can help precisely locate the source of errors.
This project is distributed under the terms of the EUPL FOSS license
REST Resources Design Workflow
REST Resources Single items and collections
REST Resources Many to many Relations
REST Resources Relations expansion
HTTP Status Codes Success (2xx)
HTTP Status Codes Redirection (3xx)
HTTP Status Codes Client Error (4xx)
HTTP Status Codes Server Error (5xx)
Pagination Out of range/bounds
Long-running Operations Example
Concurrency vs Delete operation
Caching and conditional requests About
Caching and conditional requests Rules
Caching and conditional requests HTTP headers
Error handling Example with a single error
Error handling Example with multiple errors
Error handling Example with parameters
Error handling Example with additional metadata
Bulk operations HTTP status codes
Bulk operations Resources naming convention
Bulk operations Creation example
Bulk operations Update example
Bulk operations Create and update example
File upload Simple file upload
File upload Simple file upload example
File upload Complex file upload
File upload Complex file upload example
REST Security General recommendations
REST Security Insecure direct object references