Pular para o conteúdo principal

Anos de Fabricação por Modelo

Consulte os anos de fabricação disponíveis para um modelo específico.

Endpoint​

GET /catalog/model/{id}/years

Método​

GET

Parâmetros de URL​

ParâmetroTipoDescrição
idintegerID do modelo de veículo

Autenticação​

Este endpoint requer autenticação via JWT. Inclua o token no header:

Authorization: Bearer {access_token}

Exemplo de Resposta​

Status Code: 200 OK

[2020, 2021, 2022, 2023, 2024, 2025]

Exemplo de Resposta Vazia​

Quando não há anos disponíveis para o modelo, a resposta será uma lista vazia:

Status Code: 200 OK

[]

Estrutura de Dados​

A resposta é um array de inteiros representando os anos de fabricação disponíveis para o modelo, do ano mínimo ao ano máximo (inclusive).

O sistema calcula automaticamente:

  • Ano mínimo: Baseado no start_year mais antigo das versões detalhadas do modelo
  • Ano máximo: Baseado no end_year mais recente das versões detalhadas do modelo, limitado ao ano atual

Se o modelo não possui versões detalhadas com anos definidos, ou se o ano mínimo for maior que o ano máximo, a resposta será uma lista vazia.

Exemplo de Uso​

Requisição:

GET /catalog/model/123/years

Resposta:

[2018, 2019, 2020, 2021, 2022, 2023, 2024]

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 o modelo especificado não é encontrado.

{
  "detail": "Não encontrado."
}