Motocicleta - Estilo
Consulte os estilos de motocicleta disponíveis no sistema.
Endpoint
GET /catalog/motorcycle/style
GET /catalog/motorcycle/style/{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 Estilos
Status Code: 200 OK
[
{
"id": 1,
"name": "Esportiva"
},
{
"id": 2,
"name": "Custom"
},
{
"id": 3,
"name": "Naked"
},
{
"id": 4,
"name": "Trail"
},
{
"id": 5,
"name": "Scooter"
}
]
Detalhe de um Estilo
Status Code: 200 OK
{
"id": 1,
"name": "Esportiva"
}
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 estilo |
name | string | Nome do estilo de motocicleta |
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 estilo específico não é encontrado (ao acessar /catalog/motorcycle/style/{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."
}