> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Lista de erros do SISBAJUD

> Consulte um código de erro do SISBAJUD, o status HTTP que ele carrega, e a ação que o resolve.

**Formato do erro**

O SISBAJUD retorna erros com um `code` estável. Um erro de operação usa problem details RFC 9457, com o media type `application/problem+json`:

<CodeGroup>
  ```json JSON theme={null}
  {
    "type": "https://errors.lerian.studio/v1/SBJ-0001",
    "title": "Bad Request",
    "status": 400,
    "detail": "institutionId path parameter must be a valid non-nil UUID.",
    "code": "SBJ-0001"
  }
  ```
</CodeGroup>

**Definições de campos**

* **`code`** – Um identificador estável para o erro, na forma `SBJ-NNNN`. Baseie sua lógica neste valor quando a resposta o trouxer, e no status caso contrário.
* **`type`** – Uma URI que identifica o erro no catálogo de erros da Lerian. Construída como `https://errors.lerian.studio/v1/<code>`.
* **`title`** – O texto do status HTTP (por exemplo, `Bad Request`).
* **`status`** – O código de status HTTP.
* **`detail`** – Orientação para esta ocorrência do erro. Para respostas `5xx`, o detail traz o texto estático `internal error`, então use `code` para basear sua lógica.
* **`errors`** – Lista opcional de detalhes de validação por campo, cada um com um `message` e um `location`.

Uma recusa que o roteador faz antes de a requisição chegar a uma operação, como um método não suportado, responde com o mesmo `code` e `title` em um corpo JSON simples.

## Erros do cliente

***

| `code`   | Descrição                                                                                                                                                             | Status      |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| SBJ-0001 | A requisição tem sintaxe malformada. Verifique os identificadores do path, o formato do timestamp e os comprimentos dos campos.                                       | 400         |
| SBJ-0003 | Falha na autenticação. Envie um bearer token válido.                                                                                                                  | 401         |
| SBJ-0004 | A identidade do chamador não tem permissão para este recurso.                                                                                                         | 403         |
| SBJ-0005 | O recurso não existe. Verifique o identificador no path.                                                                                                              | 404         |
| SBJ-0007 | A requisição conflita com o estado atual do recurso, como uma criação duplicada ou uma requisição que já alcançou um estado terminal.                                 | 409         |
| SBJ-0010 | O payload da requisição, ou o conteúdo do arquivo que a requisição solicitou, está acima do tamanho aceito.                                                           | 413         |
| SBJ-0006 | A sintaxe está correta, mas o serviço não consegue processar a requisição. Um valor está fora do conjunto aceito, ou o recurso está no estado errado para a operação. | 422         |
| SBJ-0011 | Um erro de cliente fora dos códigos acima, como um método HTTP não suportado. Leia o status HTTP da resposta.                                                         | Outro `4xx` |

## Erros do servidor

***

| `code`   | Descrição                                                                                                                                                   | Status |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| SBJ-0002 | O serviço falhou inesperadamente. Envie a requisição novamente, e entre em contato com o suporte se a falha continuar.                                      | 500    |
| SBJ-0008 | Uma dependência que este endpoint precisa está indisponível. Entre em contato com sua equipe de plataforma; enviar a requisição novamente não resolve isso. | 503    |