Códigos de status do apêndice A

As solicitações de API WS do Service Desk sempre retornam uma resposta padrão. Deve ser usado um status de resposta para determinar se a solicitação foi bem-sucedida ou não. A resposta padrão compreende um código de status e uma mensagem de texto de status associada.

A mensagem de status é uma breve descrição em inglês que pode ser exibida para o usuário. Se você exibir a mensagem de status, também deverá exibir o código de status.

Os clientes podem reconhecer os códigos de status, não as mensagens de status. Quando uma solicitação não pode ser concluída com êxito, a falha real ou uma mensagem de erro é retornada. Esse comportamento pode variar um pouco de mensagens que são listadas neste apêndice.

Algumas falhas são específicas a determinadas chamadas, enquanto outras são falhas mais gerais que podem ocorrer em qualquer chamada. Por exemplo, código de status 100 para um acesso é negado devido a credenciais inválidas.

0xx: código de status de êxito	Mensagem
000	Êxito: a solicitação foi atendida pelo servidor; o serviço retornou resultados da operação.
001	Êxito: a solicitação foi atendida pelo servidor; nenhum resultado foi retornado pelo serviço.
1xx: código de status de erro de autorização	Mensagem
100	Não autorizado: acesso negado devido a credenciais inválidas.
101	Erro de licença: você não tem uma licença apropriada para usar nenhum serviço.
2xx: código de status de erro de acesso à operação	Mensagem
200	Erro de invocação: a definição de operação para o serviço solicitado não foi encontrada.
201	Erro de invocação: a operação do serviço solicitado foi desativada.
3xx: código de status de erro de pré-processamento da operação	Mensagem
300	Erro de execução: um erro inesperado ocorreu durante a transformação de dados dos parâmetros da solicitação transmitidos durante a invocação do serviço web: {0}.{1}.
301	Erro de execução: um erro inesperado ocorreu durante a validação de dados dos parâmetros da solicitação transmitidos durante a invocação do serviço web: {0}.{1}.
4xx: código de status de erro de execução do terminal	Mensagem
400	Erro de execução: ocorreu uma exceção não tratada no terminal do serviço (provedor) durante a execução do serviço solicitado.
401	Erro de execução: alguns erros foram capturados pelo terminal do serviço (provedor) durante a execução do serviço solicitado.
402	Erro de execução: ocorreu um erro inesperado ao processar a resposta do serviço no formato solicitado.
403	Erro de execução: ocorreu um erro inesperado ao processar o serviço solicitado.