Códigos de estado HTTP

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

Tabla 1. Códigos de estado HTTP
Código de estado HTTP Mensaje de estado HTTP Descripción
200 Aceptar La solicitud se ha realizado correctamente. Se proporciona un cuerpo de respuesta que contiene los resultados de la solicitud.
204 Sin contenido La solicitud se ha realizado correctamente y no se proporciona información de respuesta adicional.
400 Solicitud errónea A la solicitud le faltaba una entrada necesaria, tenía errores en la entrada proporcionada o incluía una entrada extraña. Se proporciona información adicional con respecto al error en un cuerpo de respuesta de error que incluye un código de razón con información adicional.
403 Sin autorización Varias condiciones de error dan como resultado este código de estado:
  • La solicitud requiere autenticación, pero no se ha proporcionado ninguna cabecera X-API-Session, o se ha proporcionado una, pero el ID de sesión no era válido.
  • El usuario bajo el que se ha autenticado la solicitud de API no tiene autorización para realizar la operación solicitada.
404 No se ha encontrado Varias condiciones de error dan como resultado 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 está en un estado incorrecto (estado) para realizar la operación solicitada. Se proporciona información adicional con respecto al error en un cuerpo de respuesta de error que incluye un código de razón con información adicional.
412 Recurso modificado La condición previa ha fallado. Si el ETag proporcionado por el cliente y el ETag del servidor coinciden, continúe con POST. De lo contrario, se producirá un error de modificación de recurso 412.
413 Cuerpo de solicitud demasiado grande La solicitud incluye un cuerpo de solicitud que es demasiado grande.
415 Tipo de soporte no compatible La cabecera Content-Type para la solicitud especifica una representación que no está soportada por la API Web Services .
500 Error interno del servidor Se ha producido un error de servidor durante el proceso de la solicitud.
501 No implementado La solicitud especifica un método HTTP que el servidor no reconoce (para cualquier recurso).
503 Servicio no disponible La solicitud no ha podido ser realizada por el MC debido a alguna condición temporal.
505 Versión de HTTP no soportada La solicitud especifica una versión de protocolo HTTP que no está soportada por la API de Web Services .