Fipe 表格库

2.5.0 2024-06-03 21:29 UTC

This package is auto-updated.

Last update: 2024-09-03 22:13:30 UTC


README

PHP 库,用于查询 Fipe 表格 💰 Fipe 查询表格 API 通过 RESTful HTTP Json 服务提供全国市场车辆的平均价格。每月更新一次,数据来自 Fipe 表格。

重要

经过近 10 年的维护、更新和完全免费无限提供,我不得不做出决定,对 API 使用量进行限制。从现在起,API 将限制为每天(24小时)500次免费未认证的请求。如果您在这里创建访问令牌,则每天(24小时)可以执行至多 1000 次请求。

如果您需要无限请求和访问 1 年的价格历史记录,请考虑通过fipe.online网站购买支持计划。

API 状态

Uptime Robot status Uptime Robot status

使用的 API

该库用于获取 Fipe 数据的 API 文档可在此链接找到,也可以在存储库的gh-pages 分支中找到。

类和方法

该库包含 3 个类用于查询 Fipe 表格,每个类对应一种车型,它们是

  • FipeCaminhoes 查询卡车表格
  • FipeCarros 查询汽车表格
  • FipeMotos 查询摩托车表格

每个类都有以下方法

  • getMarcas() 返回一个包含车辆类型选择的品牌代码和名称的数组
  • getModelos($codMarca) 返回一个包含品牌代码和名称的模型数组的数组
  • getAnos($codMarca, $codModelo) 返回一个包含车辆模型年份代码和名称的数组
  • getVeiculo($codMarca, $codModelo, $codAno) 返回一个包含指定车辆 Fipe 表格数据的数组

使用示例

查看如何查询汽车品牌的一个示例

<?php
use DeividFortuna\Fipe\FipeCarros;

$marcas = FipeCarros::getMarcas();

var_dump($marcas);

使用访问令牌增加请求限制

<?php
use DeividFortuna\Fipe\FipeCarros;

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

$marcas = FipeCarros::getMarcas();

var_dump($marcas);

上面的代码将返回一个数组

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

一个功能示例可以在项目的 exemplo 文件夹中找到。

许可协议

版权 (c) 2016 Deivid Fortuna