Todas las respuestas incluyen un código de estado HTTP y, a menos que el código de estado sea 204 (Sin contenido), un encabezado de aceptación. El contenido de la respuesta depende de la solicitud. Algunas respuestas incluyen un cuerpo de documento, algunas solo una URL y otras están vacías.

Códigos de respuesta HTTP

Un cliente de API puede esperar un subconjunto de códigos de estado HTTP en una respuesta.

Tabla 1. Códigos de estado HTTP que devuelve la API
Código de estado Descripción de estado
200 OK La solicitud es válida y se ha completado. La respuesta incluye un cuerpo de documento.
201 Creado La solicitud es válida. El objeto solicitado se ha creado y se puede encontrar en la URL especificada en el encabezado de ubicación.
202 Aceptado La solicitud es válida y se ha creado una tarea para controlarla. Esta respuesta suele ir acompañada de un elemento TaskStatus.
204 Sin contenido La solicitud es válida y se ha completado. La respuesta no incluye un cuerpo.
400 Solicitud errónea El cuerpo de la solicitud tiene un formato incorrecto, está incompleto o bien no es válido.
401 No autorizado Se ha producido un error en el inicio de sesión o el token de autenticación ha caducado.
403 Prohibido El usuario no está autenticado o bien no tiene los privilegios adecuados para acceder a uno o varios objetos especificados en la solicitud.
404 No encontrado No se ha podido encontrar el objeto especificado en la solicitud.
405 Método no permitido El método HTTP especificado en la solicitud no es compatible con este objeto.
406 No aceptable El recurso identificado por la solicitud no puede generar una respuesta del tipo especificado en el encabezado Accept de la solicitud.
415 Tipo de medio no compatible El recurso identificado por la solicitud no admite una solicitud del Content-Type y el método HTTP especificados.
422 No encontrado Por lo general, indica una URL de solicitud o cuerpo de solicitud con formato incorrecto.
429 Demasiadas solicitudes Un cliente ha enviado demasiadas solicitudes o varios clientes están enviando demasiadas solicitudes simultáneas y el servidor no puede procesarlas debido a límites de velocidad.

Para solucionar el problema, intente volver a enviar la solicitud más tarde.

500 Error interno del servidor Se ha recibido la solicitud, pero no se ha podido completar debido a un error interno en el servidor.
503 Servicio no disponible El servidor no puede procesar la solicitud en este momento debido a una condición temporal, como el agotamiento de recursos o el mantenimiento del servidor.
504 Tiempo de espera agotado para la puerta de enlace El servidor, mientras actúa como puerta de enlace o proxy, no ha recibido una respuesta oportuna del servidor que precede en la cadena especificado por la URL de solicitud.