API Dados do veiculo por placa utilzando PHP e Guzzle

Publicado em por

API Busca Veículos: tutorial definitivo para consultar placa em PHP

API Busca Veículos é o serviço oficial da APIBrasil que devolve marca, modelo, ano e chassi
usando apenas a placa. Logo de início, você aprenderá a integrar a
API Busca Veículos em PHP com Guzzle; além disso, vamos cobrir
credenciais, limites e segurança. Portanto, siga o guia abaixo para dominar
essa integração.

Sumário deste guia sobre a API Busca Veículos

  1. Por que usar a API Busca Veículos?
  2. Pré‑requisitos e instalação
  3. Criando plate.php
  4. Obtendo credenciais da API Busca Veículos
  5. Código comentado
  6. Teste rápido
  7. Limites do plano gratuito
  8. Boas práticas de produção
  9. Segurança e links úteis
  10. FAQ

1. Por que usar a API Busca Veículos?

Primeiramente, a API Busca Veículos elimina a necessidade de bases privadas caras.
Além disso, o endpoint retorna JSON padronizado, consequentemente
acelerando a integração com CRMs. Para quem precisa de dados confiáveis,
é a rota mais eficiente — veja a documentação oficial em
docs.apibrasil.com.br.

2. Pré‑requisitos para integrar a API Busca Veículos

Antes de mais nada, certifique‑se de ter:

  • PHP 8.1 ou superior;
  • Composer instalado;
  • Conta na APIBrasil;
  • Tokens DeviceToken e BearerToken.

Em seguida, instale o Guzzle:

composer require guzzlehttp/guzzle

3. Criando o arquivo plate.php

Logo depois, crie plate.php — será nosso ponto de entrada.

4. Obtendo credenciais da API Busca Veículos

Primeiramente, faça login e copie seus tokens em Minhas APIs → API Placa Dados.
Depois disso, exporte‑os como variáveis de ambiente para mantê‑los seguros.

5. Código comentado da API Busca Veículos

<?php
require_once __DIR__.'/vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Psr7\Request;

$client = new Client(['base_uri' => 'https://gateway.apibrasil.io', 'timeout' => 10]);

$headers = [
    'Content-Type' => 'application/json',
    'DeviceToken'  => getenv('DEVICE_TOKEN'),
    'Authorization'=> 'Bearer '.getenv('BEARER_TOKEN'),
];

$body = json_encode(['placa' => 'OQH3065']);

$request = new Request('POST', '/api/v2/vehicles/dados', $headers, $body);
$response = $client->send($request);

$data = json_decode($response->getBody(), true, 512, JSON_THROW_ON_ERROR);
print_r($data);

6. Testando a API Busca Veículos no terminal

Assim que salvar, rode php plate.php. Se tudo der certo,
um JSON com marca, modelo e chassi será exibido.

7. Limites do plano gratuito da API Busca Veículos

Atualmente, são 100 requisições diárias; dessa forma,
é viável validar POCs sem custo.

8. Boas práticas de produção usando a API Busca Veículos

  • Cache placas repetidas. Dessa maneira, economiza chamadas.
  • Retry exponencial em timeout. Além disso, registre falhas.
  • Rotacione tokens a cada 90 dias. Consequentemente, reduz impacto de vazamentos.

9. Segurança e links úteis sobre a API Busca Veículos

Contudo, nunca armazene BearerToken em texto‑plano.
Portanto, use cofres de segredos, como
HashiCorp Vault.
Além disso, consulte nosso
guia interno de segurança.

10. FAQ sobre a API Busca Veículos

Quantas consultas por minuto?

≈ 5 no plano free.

A API aceita cURL?

Sim, todavia, Guzzle facilita retries.

Conclusão sobre a API Busca Veículos

Por fim, integrar a API Busca Veículos com PHP e Guzzle
é rápido, seguro e escalável.