Códigos de error y estado de HTTP

Todas las respuestas HTTP contienen un código de estado de HTTP. Los números de código de respuesta HTTP correctos oscilan entre 200 y 399. Los números de código de respuesta de error HTTP estándar oscilan entre 400 y 599.

La lista siguiente muestra los números de código de respuesta de error y correcta que la API REST devuelve para cada uno de los métodos HTTP.

GET (único)

200, 400, 401, 404, 409

GET (recopilación)

200, 400, 401

PUT

200, 400, 401, 404, 409

DELETE

204, 400, 401, 409

POST

201, 400, 401, 409

Nota: Para las operaciones PUT y DELETE, la API no intenta determinar en un principio la validez del ID. En cambio, la API intenta ejecutar la actualización y suprimir las consultas directamente. Si se produce un error, la API devuelve el código 409 Conflicto. Si la API devuelve un código 404 No encontrado en esta situación, el rendimiento se ve afectado.

Asimismo, se reciben los mensajes de error siguientes en estos casos:

• Si la solicitud HTTP contiene una dirección URI no válida o inaccesible, el servidor responde con un código de respuesta 404 No encontrado.
• Si la solicitud HTTP contiene un método HTTP no compatible para una dirección URI válida, el servidor responde con un código de respuesta 405 Método no permitido.
• Si la solicitud HTTP solicita un tipo de medio no compatible (encabezado Acepto), el servidor responde con un código de respuesta 406 No aceptable.
• Si la solicitud HTTP envía un tipo de medio no compatible (encabezado de tipo de contenido), el servidor responde con un código de respuesta 415 Tipo de medio no soportado.
• Varios errores de sintaxis o de servidor Web internos pueden devolver un error interno 500.