Motocicleta - Tipo de Refrigeração
Consulte os tipos de refrigeração disponíveis para motocicletas no sistema.
Endpoint
GET /catalog/motorcycle/cooling
GET /catalog/motorcycle/cooling/{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 Refrigeração
Status Code: 200 OK
[
{
"id": 1,
"name": "Ar"
},
{
"id": 2,
"name": "Líquida"
},
{
"id": 3,
"name": "Ar e Óleo"
}
]
Detalhe de um Tipo de Refrigeração
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 refrigeração |
name | string | Nome do tipo de refrigeração |
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 refrigeração específico não é encontrado (ao acessar /catalog/motorcycle/cooling/{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."
}