API Rastreio de encomendas correios

Publicado em por

API Rastreio de encomendas correio: guia completo para acompanhar pacotes via PHP

API Rastreio de encomendas correio é a solução ideal para automatizar a conferência de objetos dos
Correios. Assim que você integra, portanto, basta enviar um código de rastreio e, logo depois,
receber o status atualizado no seu sistema. Dessa forma, a automação melhora a experiência
do cliente e, além disso, reduz consultas manuais ao site oficial.

Por que usar esta API de rastreamento dos Correios?

Primeiramente, ela elimina tarefas repetitivas. Em segundo lugar, centraliza todas as consultas em
um único endpoint confiável. Além disso, por devolver JSON estruturado, conecta‑se
facilmente a bots, ERPs ou painéis internos. Consequentemente, o time de suporte
ganha tempo e a logística fica mais ágil. Por outro lado, caso você dependa de scraping,
o risco de bloqueio aumenta; portanto, a API oferece uma abordagem sustentável.

API Rastreio de encomendas correio: instalação rápida

Antes de mais nada, instale o Guzzle com Composer:

composer require guzzlehttp/guzzle

Exemplo de código em PHP (Guzzle)

Logo em seguida, copie o snippet abaixo e ajuste suas variáveis de ambiente.


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

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

$device = getenv('DEVICE_TOKEN');
$token  = getenv('BEARER_TOKEN');

if (!$device || !$token) {
    throw new RuntimeException('Credenciais ausentes.');
}

$client = new Client([
    'base_uri' => 'https://gateway.apibrasil.io',
    'timeout'  => 10,
    'headers'  => [
        'Content-Type' => 'application/json',
        'DeviceToken'  => $device,
        'Authorization'=> "Bearer {$token}",
    ],
]);

try {
    $payload  = ['code' => 'QP817120689BR'];
    $response = $client->post('/api/v2/correios/rastreio', ['json' => $payload]);
    $events   = json_decode($response->getBody(), true, 512, JSON_THROW_ON_ERROR);

    print_r($events);                        // exibe os eventos
} catch (RequestException $e) {
    echo 'Falha na requisição: ' . $e->getMessage();
} catch (Throwable $e) {
    echo 'Erro inesperado: ' . $e->getMessage();
}

Fluxo resumido

  1. Primeiro, o Guzzle é instanciado com a base_uri do gateway.
  2. Em seguida, o script envia o código de rastreio ao endpoint.
  3. Depois disso, a resposta JSON é transformada em array e listada em ordem cronológica.

Segurança e links úteis

Contudo, não armazene o Bearer Token em texto‑plano. Portanto, use variáveis
de ambiente ou cofres de segredos; dessa maneira, você evita vazamentos e mantém compliance.
Para detalhes, consulte nosso guia de boas práticas.

Próximos passos na integração

  1. Primeiro, gere credenciais no painel da APIBrasil.
  2. Logo depois, teste o snippet com seu próprio código de rastreio.
  3. Posteriormente, para múltiplos objetos, consulte /rastreio/lote na documentação.

Conclusão e recursos adicionais

Por fim, integrar esta API de rastreamento permite enviar notificações precisas e aumentar
a satisfação do usuário. Se desejar expandir, veja nosso
tutorial de integração com WhatsApp

 

e outros serviços em apibrasil.com.br.

Loading