Caminhão - Tipo de Freio
Consulte os tipos de freio disponíveis para caminhões no sistema.
Endpoint
GET /catalog/truck/break
GET /catalog/truck/break/{id}
Método
GET
Autenticação
Este endpoint requer autenticação via JWT. Inclua o token no header:
Authorization: Bearer {access_token}
Exemplo de Resposta
Lista de Tipos de Freio
Status Code: 200 OK
[
{
"id": 1,
"name": "Ar"
},
{
"id": 2,
"name": "Disco"
},
{
"id": 3,
"name": "Tambor"
}
]
Detalhe de um Tipo de Freio
Status Code: 200 OK
{
"id": 1,
"name": "Ar"
}
Estrutura de Dados
A resposta é um array de objetos (lista) ou um objeto único (detalhe), onde cada objeto contém:
| Campo | Tipo | Descrição |
|---|---|---|
id | integer | Identificador único do tipo de freio |
name | string | Nome do tipo de freio |
Possíveis Retornos de Erro
401 Unauthorized
Retornado quando o token de autenticação não foi fornecido ou é inválido.
{
"detail": "As credenciais de autenticação não foram fornecidas."
}
ou
{
"detail": "Token inválido ou expirado."
}
403 Forbidden
Retornado quando o usuário autenticado não tem permissão para acessar este recurso.
{
"detail": "Você não tem permissão para executar essa ação."
}
404 Not Found
Retornado quando um tipo de freio específico não é encontrado (ao acessar /catalog/truck/break/{id}).
{
"detail": "Não encontrado."
}
405 Method Not Allowed
Retornado quando um método HTTP não permitido é utilizado (ex: DELETE, POST, PUT, PATCH).
{
"detail": "Método \"DELETE\" não é permitido."
}