Walidacja adresów przez API

Przykład

curl -X POST https://api.adresy.app/api/v1/match \
  -H "X-API-Key: TWÓJ_KLUCZ_API" \
  -H "Content-Type: application/json" \
  -d '{"addresses": ["ul. Legnicka 12, Wrocław"]}'

Odpowiedź zawiera dla każdego adresu status, dopasowany rekord (match), listę flags z przyczynami wątpliwości oraz candidates, gdy wynik nie jest jednoznaczny.

Cztery statusy

Zasada: nie zgadujemy za klienta

Jeśli numer nie istnieje w PRG, wynik to low_confidence z flagą NUMBER_NOT_IN_PRG i listą podobnych numerów przy tej ulicy. Nie podstawiamy sąsiedniego budynku, bo przesyłka trafiłaby pod zły adres. Szczegóły: Weryfikacja poprawności adresu.

Co zwraca walidacja

• Standaryzowany zapis: miejscowość, ulica, numer budynku, numer lokalu.
• Kod pocztowy i gmina z punktu PRG.
• Kody TERYT: SIMC, ULIC, TERC.
• Współrzędne punktu adresowego.
• Stały identyfikator AID.
• Dane budynku z BDOT10k (rodzaj, liczba kondygnacji) i flaga WIELORODZINNY_BEZ_LOKALU, gdy w budynku wielorodzinnym brakuje numeru lokalu.

Pliki zamiast pojedynczych zapytań

Bazę klientów albo kontrahentów wgrasz jako CSV lub XLSX. Wynik dostajesz z dopisanymi kolumnami (status, poprawny adres, kody TERYT, współrzędne). Przetwarzanie plików jest dostępne od planu Starter; limity wierszy zależą od planu:

Jak przygotować plik: Weryfikacja adresów z pliku CSV.

Czego walidacja nie potwierdza

Zgodność z PRG oznacza, że adres istnieje i jest poprawnie zapisany. Nie oznacza, że klient pod nim mieszka ani że przesyłka zostanie doręczona. To jeden z kroków procesu — nie zamiennik weryfikacji tożsamości.

Walidacja w formularzu a walidacja po zapisie

W formularzu lepiej podpowiadać adres niż sprawdzać go po wpisaniu: klient nie popełnia błędu, który trzeba potem poprawiać. Walidację po zapisie stosuj do danych z innych źródeł (import, integracje, stare bazy). Szczegóły: Walidacja adresu w formularzu.