HTTP Códigos de status

A API MC usa códigos de status padrão HTTP em resposta para indicar o sucesso ou a falha da solicitação. Salvo indicação em contrário na descrição de uma operação, aplicam-se as seguintes interpretações gerais dos valores do código de status.

Tabela 1. HTTP Códigos de status
HTTP Código de status HTTP Mensagem de status Descrição
200 OK: A solicitação foi totalmente bem-sucedida. É fornecido um corpo de resposta que contém os resultados da solicitação.
204 Sem conteúdo A solicitação foi totalmente bem-sucedida e nenhuma informação adicional de resposta é fornecida.
400 Solicitação inválida A solicitação não tinha as entradas necessárias, tinha erros nas entradas fornecidas ou incluía entradas estranhas. Informações adicionais sobre o erro são fornecidas em um corpo de resposta de erro que inclui um código de motivo com informações adicionais.
403 Proibido Várias condições de erro resultam nesse código de status:
  • A solicitação requer autenticação, mas nenhum cabeçalho X-API-Session foi fornecido, ou um foi fornecido, mas a ID da sessão era inválida.
  • O usuário sob o qual a solicitação de API foi autenticada não está autorizado a executar a operação solicitada.
404 Não encontrado Várias condições de erro resultam nesse código de status:
  • O URI não designa um recurso existente ou designa um recurso para o qual o usuário da API não tem permissão de acesso a objetos.
  • O URI designa um recurso ou uma operação que não é compatível com o MC porque ele é atualmente o MC alternativo.
405 Método não permitido A solicitação especifica um método HTTP que não é válido para o URI designado.
409 Conflito O recurso gerenciado está em um estado (status) incorreto para executar a operação solicitada. Informações adicionais sobre o erro são fornecidas em um corpo de resposta de erro que inclui um código de motivo com informações adicionais.
412 Recurso modificado Precondição falhou. Se o ETag fornecido pelo cliente e o ETag do servidor corresponderem, prossiga com o POST. Caso contrário, resultará em um erro de 412 recursos modificados.
413 Corpo da Solicitação Muito Grande A solicitação inclui um corpo de solicitação muito grande.
415 Tipo de Mídia Não Suportado O cabeçalho Content-Type da solicitação especifica uma representação que não é compatível com a API Web Services .
500 Erro interno do servidor Ocorreu um erro no servidor durante o processamento da solicitação.
501 Não implementado A solicitação especifica um método HTTP que não é reconhecido pelo servidor (para qualquer recurso).
503 Serviço Indisponível A solicitação não pôde ser realizada pelo MC devido a alguma condição temporária.
505 Versão HTTP Não Suportada A solicitação especifica uma versão do protocolo HTTP que não é compatível com a API Web Services .