SINESP Cidadao API 客户端

该软件包的官方仓库似乎已不存在,因此该软件包已被冻结。

dev-master 2018-07-11 18:23 UTC

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) 方法,也可以使用一个包含 ipporta 键的关联数组作为 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提供密钥。