Pular para o conteúdo principal

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:

CampoTipoDescrição
idintegerIdentificador único do tipo de marcha
namestringNome 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."
}