Como consultar CEP com PHP

Requisição com cURL

Use a URL do domínio principal e mantenha a API key no servidor. O endpoint retorna um envelope JSON com os registros encontrados.

<?php
$ch = curl_init('https://brasiladdress.io/api/v1/cep/01001000');
curl_setopt_array(, [CURLOPT_HTTPHEADER => ['X-API-Key: '.getenv('BRASILADDRESS_API_KEY')], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 15]);
$body = curl_exec();
$status = curl_getinfo(, CURLINFO_HTTP_CODE);
curl_close();
if ( >= 400) { throw new RuntimeException( ?: 'Falha na consulta'); }
$data = json_decode(, true, 512, JSON_THROW_ON_ERROR);

Erros e limites

Trate 401 para credencial ausente ou inválida, 422 para parâmetros inválidos e 429 para rate limit ou quota. Use timeout e backoff para falhas transitórias.