HTTP Códigos de estado

La API MC utiliza códigos de estado estándar HTTP en la respuesta para indicar el éxito o el fracaso de la solicitud. A menos que se indique lo contrario en la descripción de una operación, se aplican las siguientes interpretaciones generales de los valores de los códigos de estado.

Tabla 1. HTTP Códigos de estado
HTTP Código de estado HTTP Mensaje de estado Descripción
200 Aceptar La solicitud ha tenido éxito por completo. Se proporciona un cuerpo de respuesta que contiene los resultados de la solicitud.
204 Sin contenido La solicitud se ha completado con éxito y no se proporciona ninguna información de respuesta adicional.
400 Solicitud errónea En la solicitud faltaban datos obligatorios, había errores en los datos introducidos o había datos extraños. Se proporciona información adicional sobre el error en un cuerpo de respuesta de error que incluye un código de motivo con información adicional.
403 Prohibido Varias condiciones de error dan lugar a este código de estado:
  • La solicitud requiere autenticación pero no se proporcionó ningún encabezado X-API-Session, o se proporcionó uno pero el ID de sesión no era válido.
  • El usuario con el que se autenticó la solicitud de API no está autorizado a realizar la operación solicitada.
404 No se ha encontrado Varias condiciones de error dan lugar a este código de estado:
  • El URI no designa un recurso existente, o designa un recurso para el que el usuario de la API no tiene permiso de acceso a objetos.
  • El URI designa un recurso u operación que no está soportado por el MC porque actualmente es el MC alternativo.
405 Método no permitido La solicitud especifica un método HTTP que no es válido para el URI designado.
409 Conflicto El recurso gestionado se encuentra en un estado incorrecto para realizar la operación solicitada. Se proporciona información adicional sobre el error en un cuerpo de respuesta de error que incluye un código de motivo con información adicional.
412 Recursos modificados Precondición fallida. Si el ETag proporcionado por el cliente y el ETag del servidor coinciden, proceda con POST. En caso contrario, se produce un error de 412 recursos modificados.
413 Cuerpo de solicitud demasiado grande La solicitud incluye un cuerpo de solicitud demasiado grande.
415 Tipo de soporte no compatible El encabezado Content-Type de la solicitud especifica una representación que no es compatible con la API Web Services .
500 Error interno del servidor Se ha producido un error en el servidor durante el procesamiento de la solicitud.
501 No implementado La solicitud especifica un método HTTP que no es reconocido por el servidor (para ningún recurso).
503 Servicio no disponible La solicitud no pudo ser atendida por el MC debido a alguna condición temporal.
505 Versión de HTTP no soportada La solicitud especifica una versión del protocolo HTTP que no es compatible con la API Web Services .