api: Improve error handling and response management

Use a custom DRF exception handler to generate an error response when an
exception is raised in a view.

Move api response creation from the api_doc decorator to the api_route one.

Remove the handle_response parameter from the api_doc decorator.

Related to T2657