Os seguintes códigos de status podem ser retornados em respostas HTTP.
| Código HTTP | Descrição HTTP | Observações |
|---|---|---|
| 2xx | OK | Não é um erro. Retornado quando bem-sucedido. Isso também precisa ser usado para falhas de lógica de negócios
(por exemplo, booking_failure em
CreateBookingResponse
está preenchido) |
| 400 | Solicitação inválida | Solicitação/argumentos inválidos (comerciante, serviço, espaço não encontrado, tentativa de reservar um espaço inválido, cancelamento de um agendamento que nunca existiu). |
| 401 | Não autorizado | Não autenticado (credenciais inválidas, nova tentativa de login). A solicitação não tem credenciais válidas de autenticação para a operação. |
| 403 | Proibido | Permissão negada/proibida (o autor da chamada é conhecido e rejeitado). Essa
resposta não pode ser usada para rejeições causadas pelo esgotamento de algum
recurso. Use Too Many Requests para esses erros.
Forbidden não poderá ser usado se o autor da chamada não puder ser
identificado (use Unauthorized para esses erros). |
| 404 | Não encontrado | Não encontrado (recurso não encontrado, URL inválido, inclusão de RPCs inválidas) |
| 409 | Conflito | A operação foi cancelada, geralmente devido a um problema de simultaneidade, como falha na verificação do sequenciador ou cancelamento da transação. |
| 429 | Há muitas solicitações | Alguns recursos se esgotaram, como uma cota por usuário, ou todo o sistema de arquivos está sem espaço. |
| 499 | Solicitação encerrada pelo cliente | A operação foi cancelada, geralmente pelo autor da chamada. |
| 500 | Erro interno do servidor | Erros internos. Isso significa que algumas variantes esperadas pelo sistema subjacente foram corrompidas. Esse código é reservado para erros graves. |
| 501 | Não implementado | A operação não foi implementada ou não tem suporte nem está ativada neste serviço. |
| 503 | Serviço não disponível | O serviço não está disponível no momento. Provavelmente, essa é uma condição temporária, que pode ser corrigida ao tentar novamente com uma espera. |
| 504 | Tempo limite de gateway | O prazo expirou antes do término da operação. Para operações que alteram o estado do sistema, esse erro pode ser retornado mesmo que a operação tenha sido concluída com êxito. Por exemplo, uma resposta bem-sucedida de um servidor pode ter sido atrasada tempo suficiente para que o prazo expirasse. |
Às vezes, vários códigos de erros podem ser aplicados. Os serviços retornam o código de erro mais específico aplicável.