FipeLib

Biblioteca em PHP para consultar a tabela Fipe :moneybag: API de Consulta Tabela FIPE fornece preços médios de veículos no mercado nacional através de um serviço RESTful HTTP Json. Atualizada mensalmente com dados extraidos da tabela FIPE

[!IMPORTANT] Após quase 10 anos de manutenção, atualizações e fornecimento totalmente gratuito e ilimitado, tive que tomar a decisão de colocar um limite de uso na API. A partir de agora, a API será limitada a 500 requisições gratuitas e não autenticadas por dia (24h). Se você criar um token de acesso aqui, poderá fazer até 1000 requisições por dia (24h).

Caso você precise de requisições ilimitadas e acesso a 1 ano de histórico de preços, considere contratar um plano de suporte através do site fipe.online.

API Status

API utilizada

A documentação da API utilizada pela biblioteca para obter os dados da Fipe está disponível neste link e também pode ser encontrada no branch gh-pages deste repositório.

Classes e métodos

A biblioteca possui 3 classes para consultar a tabela Fipe, uma para cada tipo de veículo, são elas:

• FipeCaminhoes consulta a tabela de caminhões
• FipeCarros consulta a tabela de carros
• FipeMotos consulta a tabela de motos

Cada classe possui os seguintes métodos:

• getMarcas() retorna um array com os códigos e nomes das marcas do tipo de veículo escolhido
• getModelos($codMarca) retorna um array com o códigos e nomes dos modelos da marca informada
• getAnos($codMarca, $codModelo) retorna um array com os códigos e nomes dos anos de um modelo de veículo
• getVeiculo($codMarca, $codModelo, $codAno) retorna um array com os dados da tabela Fipe do veículo especificado

Exemplos de uso

Veja um exemplo de como consultar as marcas de carros:

<?php
use DeividFortuna\Fipe\FipeCarros;

$marcas = FipeCarros::getMarcas();

var_dump($marcas);

Utilizando o token de acesso para aumentar o limite de requisições:

<?php
use DeividFortuna\Fipe\FipeCarros;

$token = 'SEU_TOKEN';
IFipe::setCurlOptions([
    CURLOPT_HTTPHEADER => ["X-Subscription-Token:$token"]
]);

$marcas = FipeCarros::getMarcas();

var_dump($marcas);

O código acima irá retornar um array:

[
  [
    "nome": "Acura",
    "codigo": 1
  ], [
    "nome": "Agrale",
    "codigo": 2
  ],
  // etc...
]

Um exemplo funcional pode ser encontrado na pasta exemplo deste projeto.

Licença

Copyright (c) 2016 Deivid Fortuna