hashcorptech / sinesp
SINESP Cidadao API 客户端
该软件包的官方仓库似乎已不存在,因此该软件包已被冻结。
dev-master
2018-07-11 18:23 UTC
Requires
- php: ^7.1
- ext-curl: *
- ext-libxml: *
- ext-xml: *
Requires (Dev)
- phpunit/phpunit: ^6.2
This package is not auto-updated.
Last update: 2024-02-24 07:10:03 UTC
README
SINESP Cidadão 是一个非常有用的巴西车辆公共数据库,可用于识别被盗或可疑的汽车或摩托车。
Sinesp PHP API 客户端
不幸的是,政府没有维护一个公开的 API 来执行此类查询。到目前为止,查看特定车辆的唯一方法是访问 Sinesp 网站,并针对每个请求回答验证问题(captchas
)。
因此,有必要开发一个 API 来简化对这些信息的访问。
可用的信息
如果找到指定牌照的车辆,服务器将返回以下信息
- codigoRetorno:查询返回代码
- mensagemRetorno:查询返回信息
- codigoSituacao:车辆状态代码
- situacao:车辆状态信息
- modelo:车辆型号
- marca:车辆品牌
- cor:车辆颜色
- ano:车辆制造年份
- anoModelo:车辆型号年份
- placa:查询的牌照
- data:查询日期和时间
- uf:车辆所属的州或联邦单位
- municipio:车辆所属的城市或镇
- chassi:车辆底盘号
这些信息将通过一个 关联数组
或作为对象的 属性
提供。
要求
- PHP 7.1+
- cURL
- libxml / XML
安装
使用以下命令安装最新版本
composer require hedcler/sinesp
使用
以下是一个使用该库的简单示例
<?php require 'vendor/autoload.php'; use Sinesp\Placa; $veiculo = (new Placa('CQK-6061'))->search(); print_r($veiculo);
使用 search()
方法用于定位指定牌照车辆的详细信息。
还可以通过将信息作为对象的属性访问,而不是使用方法返回的整个数组,来单独检索信息
echo 'O municipio do veiculo é ', $veiculo['municipio'];
代理
SINESP 可能会阻止来自国外的连接。如果由于连接错误(例如,timeout
错误)而导致查询没有返回结果,可以使用代理进行查询。
互联网上可以轻松找到许多免费代理(例如,http://proxylist.hidemyass.com/
)。以下是一个使用代理的示例
$veiculo = (new Placa('CQK-6061')) ->proxy(['ip'=>'177.54.144.208', 'port'=>'80']) // Com proxy, esse metodo deve ser chamado antes do metodo search() ->search(); print_r($veiculo);
可选地,而不是使用 proxy($ip, $porta)
方法,也可以使用一个包含 ip
和 porta
键的关联数组作为 buscar()
方法的第二个参数。
$client = new Placa; $veiculo = $client->search('GWW-6471', ['ip' => '177.54.144.208', 'porta' => '80']); // a consulta usara o proxy especificado print_r($veiculo);
感谢
还要感谢@ricardotominaga提供密钥。