> ## 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 Lerian SISBAJUD, o status HTTP que ele carrega, e a ação que o resolve. Uma lista serve a Mensageria e o executor.

**Formato do erro**

A Lerian SISBAJUD Mensageria e o Lerian SISBAJUD executor usam os mesmos códigos de erro, de `SBJ-0001` a `SBJ-0014`, com os mesmos status HTTP. Uma recusa de licença responde 403 com um código `LCS-`. Um erro de operação usa problem details RFC 9457, com o media type `application/problem+json`:

```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"
}
```

**Definições de campos**

* **`code`** – Um identificador estável para o erro, na forma `SBJ-NNNN`. Baseie sua lógica neste valor.
* **`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`.

Algumas recusas acontecem antes de a requisição chegar a uma operação, por exemplo um método não suportado ou um limite de taxa. Elas respondem com o mesmo `code` e `title` em um corpo JSON simples.

A API de execução, que o executor chama na Mensageria, é diferente: as suas respostas `409` e `422` usam um corpo de problema sem código `SBJ-`.

## 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-0012 | Uma operação de chave não pode seguir, e a mesma requisição falha de novo. Nada mudou. | 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-0009 | O chamador enviou requisições demais na janela atual. Aguarde o número de segundos do header `Retry-After` e envie a requisição novamente. | 429 |
| SBJ-0011 | Um erro de cliente fora dos códigos acima, como um método HTTP não suportado. A resposta mantém o seu status original, então leia o status HTTP da resposta. | Outro `4xx` |

## Erros do servidor

***

| `code` | Descrição | Status |
| - | - | - |
| SBJ-0002 | O serviço falhou inesperadamente. Um erro de servidor sem outro código também responde `SBJ-0002`. Envie a requisição novamente, e entre em contato com o suporte se a falha continuar. Para uma rotação de chave, leia [Credenciais e rotação de chaves](https://docs.lerian.studio/pt/rails/sisbajud/sisbajud-operations.md#credentials-and-key-rotation) antes de enviá-la novamente. | 500 |
| SBJ-0008 | Uma dependência que este endpoint precisa está indisponível. Entre em contato com sua equipe de plataforma se a falha continuar. | 503 |
| SBJ-0013 | O resultado de uma rotação de chave não é conhecido. Não envie a rotação novamente. | 500 |
| SBJ-0014 | A chave foi rotacionada, mas uma etapa posterior da rotação falhou. Não envie a rotação novamente. Entre em contato com o suporte. | 500 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.