Полное руководство: Как выполнять поиск CEP (почтовый индекс) с использованием API

Почтовые индексы, также известные в Бразилии как CEP (Código de Endereçamento Postal), играют решающую роль в точном определении и местоположении адресов. API (интерфейсы прикладного программирования) предоставляют удобный способ программного доступа к данным CEP и их извлечения. В этой статье мы рассмотрим несколько методов выполнения поиска CEP с использованием API, сопровождаемых примерами кода.

Методы поиска CEP с использованием API:

  1. Через API Correios:
    API Correios — это официальный API почтовой службы в Бразилии. Он обеспечивает комплексную функциональность поиска CEP. Чтобы использовать этот API, вам необходимо выполнить HTTP-запросы GET к соответствующей конечной точке, передав CEP в качестве параметра. Вот пример использования Python и библиотеки Requests:
import requests
cep = "12345678"
url = f"https://viacep.com.br/ws/{cep}/json/"
response = requests.get(url)
data = response.json()
print(data)
  1. Через API ViaCEP.
    ViaCEP – это популярный сторонний API CEP в Бразилии. Он предлагает простой и понятный способ получения данных CEP. Подобно Correios API, вы можете отправлять HTTP-запросы GET к конечной точке ViaCEP, передавая CEP в качестве параметра. Вот пример использования JavaScript и Fetch API:
const cep = "12345678";
const url = `https://viacep.com.br/ws/${cep}/json/`;
fetch(url)
  .then(response => response.json())
  .then(data => console.log(data));
  1. Использование API Postmon.
    Postmon — еще один широко используемый API CEP в Бразилии. Он предоставляет интуитивно понятный RESTful API для поиска CEP. Вы можете отправлять запросы HTTP GET на конечную точку Postmon, передавая CEP в качестве параметра. Вот пример использования PHP и cURL:
$cep = "12345678";
$url = "https://api.postmon.com.br/v1/cep/{$cep}";
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
$data = json_decode($response, true);
print_r($data);
curl_close($curl);
  1. Использование API Zippopotam.
    Zippopotam — это глобальный API почтовых индексов и местоположений, который поддерживает многие страны, включая Бразилию. Он предоставляет обширную базу данных почтовых индексов. Чтобы выполнить поиск CEP, вы можете отправить HTTP-запрос GET к конечной точке Zippopotam, передав CEP и код страны в качестве параметров. Вот пример использования Ruby и библиотеки RestClient:
require 'rest-client'
cep = "12345678"
url = "https://api.zippopotam.us/BR/#{cep}"
response = RestClient.get(url)
data = JSON.parse(response)
puts data