deividfortuna / fipe
Fipe 表格库
2.5.0
2024-06-03 21:29 UTC
Requires
- php: >=5.4.0
- ext-curl: *
- ext-json: *
Requires (Dev)
- phpunit/phpunit: ^4.8
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 状态
使用的 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