Motocicleta - Tipo de Marcha
Consulte os tipos de marcha disponíveis para motocicletas no sistema.
Endpoint
GET /catalog/motorcycle/gear
GET /catalog/motorcycle/gear/{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 Marcha
Status Code: 200 OK
[
{
"id": 1,
"name": "5 marchas"
},
{
"id": 2,
"name": "6 marchas"
},
{
"id": 3,
"name": "CVT"
}
]
Detalhe de um Tipo de Marcha
Status Code: 200 OK
{
"id": 1,
"name": "5 marchas"
}
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 marcha |
name | string | Nome do tipo de marcha |
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 marcha específico não é encontrado (ao acessar /catalog/motorcycle/gear/{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."
}