Aguarde, carregando...

API TABELA FIPE

API TABELA FIPE
Julio  Ferreira
Por: Julio Ferreira
Dia 01/10/2019 15h02

Com o API TABELA FIPE você podera integrar o seu sistema para obter dados de qualquer veículo em tempo real, sem criação de tabelas, exportando todos os dados em json.

 Como Funciona

Através de técnicas de scrapping em tempo real, utilizamos os resultados fornecidos de forma aberta na própria página da FIPE para montagem da estrutura utilizada na API.

Nenhum dado é armazenado em banco de dados, também não existem rotinas programáticas para "baixar a tabela" completamente. Toda a comunicação é feita em tempo real, como um proxy, toda resultado de consulta vem diretamente do site da Fundação FIPE.

Como Utilizar

A API disponibiliza seus dados de busca no formato JSON. Confira a URL base de acesso a API, sendo que teremos duas possiblidades, a primeira o usuário após selecionar a marca, seleciona o modelo e após o ano e a segunda possibilidade o usuário após selecionar a marca, seleciona o ano e após o modelo:

1º Passo, O parametro {{url}} será 

https://oficinaphp.com.br/fipe

2º Passo, O parametro {{codigoTipoVeiculo}} aceita três possíveis valores: 

1 (para carro, usado aqui no exemplo!)
2 (para moto)
3 (para caminhão)

CONSULTA TRADICIONAL:

3º Passo, Retornando Marcas:

{{url}}/tradicional/{{codigoTipoVeiculo}}

Será retornado um arrray com todas as marcas, o campo "Value" terá o código que sera usado nos próximos passos!

[
{
"Label": "Acura",
"Value": "1"
},
{
"Label": "Agrale",
"Value": "2"
},
{
[...]
},
{
"Label": "Hyundai",
"Value": "26"
},
{
"Label": "VW - VolksWagen",
"Value": "59"
},
{
"Label": "Wake",
"Value": "163"
},
{
"Label": "Walk",
"Value": "120"
}
]

4º Passo, no nosso exemplo iremos adicionar a marca "Hyundai", código "26", no parametro {{codigoMarca}}, para retornar dois arrays, com os modelos e anos da marca selecionada, o campo "Value" terá o código que sera usado nos próximos passos!

{{url}}/tradicional/{{codigoTipoVeiculo}}/{{codigoMarca}}

Retorno:

{
"Modelos": [
{
[...]
},
{
"Label": "HB20 Comf./C.Plus/C.Style 1.0 Flex 12V",
"Value": 6205
},
{
"Label": "HB20 Comfort Plus 1.0 TB Flex 12V Mec.",
"Value": 7546
},
{
"Label": "HB20 Comfort Style 1.0 TB Flex 12V Mec.",
"Value": 7547
},
{
"Label": "HB20 Copa do Mundo 1.0 Flex 12V Mec.",
"Value": 6739
},
{
[...]
}
],
"Anos": [
{
"Label": "32000 Gasolina",
"Value": "32000-1"
},
{
"Label": "32000 Diesel",
"Value": "32000-3"
},
{
"Label": "2020 Gasolina",
"Value": "2020-1"
},
{
"Label": "2020 Diesel",
"Value": "2020-3"
},
{
"Label": "2019 Gasolina",
"Value": "2019-1"
},
{
"Label": "2019 Diesel",
"Value": "2019-3"
},
{
"Label": "2018 Gasolina",
"Value": "2018-1"
},
{
"Label": "2018 Diesel",
"Value": "2018-3"
},
{
"Label": "2017 Gasolina",
"Value": "2017-1"
},
{
"Label": "2017 Diesel",
"Value": "2017-3"
},
{
"Label": "2016 Gasolina",
"Value": "2016-1"
},
{
"Label": "2016 Diesel",
"Value": "2016-3"
},
{
"Label": "2015 Gasolina",
"Value": "2015-1"
},
[...]
]
}

 Consulta tradicional usando um modelo para retoranar anos:

5º Passo, em sequência, usaremos o modelo "HB20 Comfort Style 1.0 TB Flex 12V Mec." substituindo o código "7547" , que estao no array "Modelos" retornado, no parametro {{codigoModelo}} no seguinte link

{{url}}/tradicional/{{codigoTipoVeiculo}}/{{codigoMarca}}/model/{{codigoModelo}}

Será retornado um array com os anos existentes do modelo selecionado

[
{
"Label": "2017 Gasolina",
"Value": "2017-1"
},
{
"Label": "2016 Gasolina",
"Value": "2016-1"
}
]

6º Passo, para finalizar, usaremos o ano "2016 Gasolina" substituindo o código "2016-1" no parametro {{ano}} no seguinte link 

{{url}}/tradicional/{{codigoTipoVeiculo}}/{{codigoMarca}}/model/{{codigoModelo}}/{{ano}} 

Será retornado um array com todos os dados do veículo escolhido:

{
"Valor": "R$ 38.088,00",
"Marca": "Hyundai",
"Modelo": "HB20 Comfort Style 1.0 TB Flex 12V Mec.",
"AnoModelo": 2016,
"Combustivel": "Gasolina",
"CodigoFipe": "015127-0",
"MesReferencia": "outubro de 2019 ",
"Autenticacao": "sqw7w4wvg0y1",
"TipoVeiculo": 1,
"SiglaCombustivel": "G",
"DataConsulta": "terça-feira, 1 de outubro de 2019 12:56"
}

Consulta tradicional usando um modelo para retoranar anos:

Após o 4º Passo, continuaremos a partir daqui!


5º Passo, em sequência, usando um ano para retoranar modelos, usaremos o ano "2016 Gasolina" substituindo o código "2016-1" no parametro {{ano}} no seguinte link 

{{url}}/tradicional/{{codigoTipoVeiculo}}/{{codigoMarca}}/year/{{ano}}


Será retornado um array com todos os dados do ano escolhido:

[
[...]
{
"Label": "HB20 C./C.Plus/C.Style 1.6 Flex 16V Mec.",
"Value": "6207"
},
{
"Label": "HB20 C.Style/C.Plus 1.6 Flex 16V Aut.",
"Value": "6206"
},
{
"Label": "HB20 Comf./C.Plus/C.Style 1.0 Flex 12V",
"Value": "6205"
},
{
"Label": "HB20 Comfort Style 1.0 TB Flex 12V Mec.",
"Value": "7547"
}[...]
]

6º Passo, para finalizar, usaremos o modelo "HB20 Comfort Style 1.0 TB Flex 12V Mec." substituindo o código "7547" no parametro {{codigoModelo}} no seguinte link

{{url}}/tradicional/{{codigoTipoVeiculo}}/{{codigoMarca}}/year/{{ano}}/{{codigoModelo}}


Será retornado um array com os anos existentes do veiculo selecionado

{
"Valor": "R$ 38.088,00",
"Marca": "Hyundai",
"Modelo": "HB20 Comfort Style 1.0 TB Flex 12V Mec.",
"AnoModelo": 2016,
"Combustivel": "Gasolina",
"CodigoFipe": "015127-0",
"MesReferencia": "outubro de 2019 ",
"Autenticacao": "sqw7w4wvg0y1",
"TipoVeiculo": 1,
"SiglaCombustivel": "G",
"DataConsulta": "terça-feira, 1 de outubro de 2019 13:04"
}

 

CONSULTA CODIGO:

Considerando o 1º e 2º passos vistos até agora, continuaremos a partir daqui!

3º Passo, neste exemplo, estamos considerando que já temos um código FIPE em mãos e iremos consulta-lo, usaremos o código "015127-0" para retornar um array com os anos disponiveis desse modelo, substituindo o parametro {{modeloCodigoExterno}} pelo código que temos no seguinte link:

{{url}}/codigo/{{codigoTipoVeiculo}}/{{modeloCodigoExterno}}

Será retornado um array com os anos do código FIPE selecionado:

[
{
"Label": "2017 Gasolina",
"Value": "2017-1"
},
{
"Label": "2016 Gasolina",
"Value": "2016-1"
}
]

4º Passo, vamos usaremos o ano "2016 Gasolina" substituindo o código "2016-1" no parametro {{ano}} no seguinte link:

{{url}}/codigo/{{codigoTipoVeiculo}}/{{modeloCodigoExterno}}/{{ano}}

Será retornado um array com os anos existentes do veiculo selecionado

{
"Valor": "R$ 38.088,00",
"Marca": "Hyundai",
"Modelo": "HB20 Comfort Style 1.0 TB Flex 12V Mec.",
"AnoModelo": 2016,
"Combustivel": "Gasolina",
"CodigoFipe": "015127-0",
"MesReferencia": "outubro de 2019 ",
"Autenticacao": "sqw7w4wvg0y1",
"TipoVeiculo": 1,
"SiglaCombustivel": "G",
"DataConsulta": "terça-feira, 1 de outubro de 2019 13:04"
}

 

Veja também:

Confira mais artigos relacionados e obtenha ainda mais dicas de controle para suas contas.