sinesp

by chapeupreto

chapeupreto / sinesp

:oncoming_automobile: API em PHP para consultar informações de veículos na base de dados do SINESP C...

131 Stars 43 Forks Last release: almost 2 years ago (v1.7.0) MIT License 39 Commits 8 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Sinesp Cidadão PHP

Latest stable release Software license Total downloads

View my other packages and projects Follow @chapeupreto on Twitter Share this package on Twitter

SINESP Cidadão é uma base de dados pública de veículos brasileiros muito útil para identificar carros ou motos roubados ou suspeitos.

Sinesp PHP API Client

Infelizmente, o governo não mantém uma API pública para realizar esse tipo de consulta. Até então, a única maneira de visualizar as informações de um determinado veículo era através do site do Sinesp respondendo a perguntas de verificação (

captchas
) para cada uma das requisições. Assim, houve a necessidade de desenvolver uma API de modo a facilitar o acesso a essas informações.

Informações Disponíveis

Se um veículo com a placa especificada for encontrado, o servidor irá retornar com as seguintes informações:

  • codigoRetorno: código de retorno da consulta
  • mensagemRetorno: mensagem de retorno da consulta
  • codigoSituacao: código da situação do veículo
  • situacao: mensagem da situação do veículo
  • modelo: modelo do veículo
  • marca: marca do veículo
  • cor: cor do veículo
  • ano: ano de fabricação do veículo
  • anoModelo: ano do modelo do veículo
  • placa: placa consultada
  • data: data e hora da consulta
  • uf: estado ou unidade federativa do veículo
  • municipio: município ou cidade do veículo
  • chassi: chassi do veículo
  • dataAtualizacaoCaracteristicasVeiculo: data atualização das características do veículo
  • dataAtualizacaoRouboFurto: data atualização de informações sobre roubo ou furto
  • dataAtualizacaoAlarme:

Essas informações estarão disponíveis por meio de um

array associativo
ou como
atributo
do objeto.

Requisitos

  • PHP 5.4+
  • cURL
  • libxml / XML

Instalação

Instale a versão mais recente com:

composer require chapeupreto/sinesp

Utilização

Abaixo um exemplo simples e geral de utilização da biblioteca:

use Sinesp\Sinesp;

$veiculo = new Sinesp;

try { $veiculo->buscar('GWW-6471'); if ($veiculo->existe()) { print_r($veiculo->dados()); } } catch (\Exception $e) { echo $e->getMessage(); }

O método

buscar()
deve ser o primeiro método a ser invocado. Esse método é empregado para localizar informações do veiculo com a placa informada.

Após a chamada ao método

buscar()
, o método
dados()
irá retornar um array associativo contendo todas as informações do veículo.

Ainda, ao invés de utilizar todo o array retornado pelo método

dados()
, pode-se também recuperar uma informação isoladamente acessando-a como atributo do objeto:
echo 'O municipio do veiculo é ', $veiculo->municipio;

Proxy

O SINESP pode bloquear conexões vindas de fora do país. Caso a consulta não retorne resultados por erro de conexão (por exemplo, erro de

timeout
), pode-se realizar uma consulta usando proxy.

Existem diversos proxy gratuitos (e.g.,

http://proxylist.hidemyass.com/
) que podem ser encontrados facilmente na Internet. Um exemplo de utilização com proxy encontra-se abaixo:
$veiculo = new Sinesp;
$veiculo->proxy('177.54.144.208', '80'); // Com proxy, esse metodo deve ser chamado antes do metodo buscar()

$veiculo->buscar('GWW-6471'); print_r($veiculo->dados());

Opcionalmente, ao invés de usar o metodo

proxy($ip, $porta)
, pode-se utilizar um array associativo com as chaves
ip
e
porta
como segundo argumento do método
buscar()
:
$veiculo = new Sinesp;
$veiculo->buscar('GWW-6471', ['ip' => '177.54.144.208', 'porta' => '80']); // a consulta usara o proxy especificado

print_r($veiculo->dados());

Timeout

Uma vez que o SINESP não mata sua requisição após bloqueio, é provável que você acabe se deparando com erro(s) 504. A fim de evitar transtorno, foi disponibilizado o método

timeout
para definir um tempo máximo de resposta:
$veiculo->timeout(5); // tempo em segundos

Dica: Em combinação com o proxy (fazendo múltiplas tentativas com diferentes proxies), isso poderá aumentar consideravelmente suas chances de sucesso para múltiplas requisições

Múltiplos erros 504 com diferentes proxies, mas sem timeout Com diferentes proxies, mas sem timeout

Maior parte dos 504 contornados usando proxy + timeout Com diferentes proxies e timeout

Agradecimentos

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.