Standardize your API error responses.
Project description
DRF Standardized Errors
Standardize your DRF API error responses.
By default, the package will convert API error responses (4xx) to the following standardized format:
{
"type": "validation_error",
"errors": [
{
"detail": "This field is required.",
"attr": "name"
},
{
"detail": "Ensure this value has at most 100 characters.",
"attr": "title",
"b_code": 10000
}
]
}
{
"type": "client_error",
"errors": [
{
"detail": "Incorrect authentication credentials.",
"attr": null,
"b_code": 11111
}
]
}
Features
- Highly customizable: gives you flexibility to define your own standardized error responses and override specific aspects the exception handling process without having to rewrite everything.
- Supports nested serializers and ListSerializer errors
- Plays nicely with error monitoring tools (like Sentry, ...)
Requirements
- python >= 3.8
- Django >= 3.2
- DRF >= 3.12
Quickstart
Install with pip
pip install drf-error-handler
Add drf-error-handler to your installed apps
INSTALLED_APPS = [
# other apps
"drf_error_handler",
]
Register the exception handler
REST_FRAMEWORK = {
# other settings
"EXCEPTION_HANDLER": "drf_error_handler.handler.exception_handler"
}
Then you may override something a few settings for package
DRF_ERROR_HANDLER = {
"EXCEPTION_RESPONSE_BUSINESS_ATTRIBUTE": "b_code"
}
This settings define, which attribute will be viewed in response body for business code.
But after that, all exception classes must containt an attribute with name, which you override in EXCEPTION_RESPONSE_BUSINESS_ATTRIBUTE
settings ("b_code" by default).
For standart DRF Exceptions defined business code in settings.
DRF_ERROR_HANDLER = {
"VALIDATION_ERROR_BUSINESS_STATUS_CODE": 1001,
"PARSE_ERROR_BUSINESS_STATUS_CODE": 1002,
"AUTHENTICATION_FAILED_BUSINESS_STATUS_CODE": 1003,
"NOT_AUTHENTICATION_BUSINESS_STATUS_CODE": 1004,
"PERMISSION_DENIED_BUSINESS_STATUS_CODE": 1005,
"NOT_FOUND_BUSINESS_STATUS_CODE": 1006,
"METHOD_NOT_ALLOWED_BUSINESS_STATUS_CODE": 1007,
"NOT_ACCEPTABLE_BUSINESS_STATUS_CODE": 1008,
"UNSUPPORTED_MEDIA_TYPE_BUSINESS_STATUS_CODE": 1009,
"THROTTLED_BUSINESS_STATUS_CODE": 1010
}
This codes will view for standart DRF and Django exceptions after handle by ErrorHandler in response body.
For create custom exception class, you should do that:
- Create exception class with inherit from
rest_framework.exceptions.APIException
from rest_framework.exceptions import APIException
class CustomException(APIException):
status_code = status.HTTP_400_BAD_REQUEST
default_detail = 'You can\'t place an order at this time.'
b_code = 1011
You must define b_code (or overriding attribute) in exception class.
- Raise custom exception.
def view(request):
...
raise CustomException
- And Error Handler process this exception and return valid response.
{
"type": "client_error",
"errors": [
{
"detail": "You can't place an order at this time.",
"attr": null,
"b_code": 1011
}
]
}
Notes
- This package is a DRF exception handler, so it standardizes errors that reach a DRF API view. That means it cannot handle errors that happen at the middleware level for example. To handle those as well, you can customize the necessary django error views. You can find more about that in this issue.
Integration with DRF spectacular
If you plan to use drf-spectacular to generate an OpenAPI 3 schema,
install with pip install drf-error-handler[openapi]
. After that, check the doc page
for configuring the integration.
Links
- Documentation: https://drf-error-handler.readthedocs.io/en/latest/
- Changelog: https://github.com/korchizhinskiy/drf-error-handler/releases
- Code & issues: https://github.com/korchizhinskiy/drf-error-handler
- PyPI: https://pypi.org/project/drf-error-handler/
License
This project is MIT licensed.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for drf_error_handler-0.15.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ac553da9c807168f90f55361dc2418957248368cdb91111703a1851fef235cde |
|
MD5 | 6e75c38a92a68fd1a8d445b4bf3d4c7c |
|
BLAKE2b-256 | 47b1a8114038ba8235997ef4e9cdc27834cd8a15bfd86864b5e7368f515c6894 |