Autocomplete și verificare de adrese pentru România

Sugerează, corectează și completează adrese din România, cu coduri poștale de la Poșta Română și localități din SIRUTA. Un singur API REST, găzduit la Frankfurt.

Obține o cheie API gratuită Citește documentația

1.000 de cereri gratuite pe lună
Fără card la început
Erori în română și engleză

GET /v1/addresses/autocomplete

Adresă

Încearcă fără diacritice sau cu o greșeală de tastare.

Sugestiile apar pe măsură ce scrii.

Rezultate live din API-ul de producție, limitate la câteva căutări pe minut.

Ce corectează Posty

Adresele vin fără diacritice, cu vechiul ş cu sedilă, cu greșeli de tastare sau cu jumătate din numele localității. Verificarea întoarce fiecare corectură pe câmp, cu motivul ei, iar tu decizi ce accepți.

Clientul a scrisPosty întoarceMotiv

BucureştiBucureștidiacritic

Mihai VitezuMihai Viteazutypo

clujCluj-Napocalocality_mismatch

MEMORANDUMULUIMemorandumuluicasing

Fiecare răspuns de verificare are și un verdict (verified, corrected, partial sau unverifiable) și un scor de încredere între 0 și 1.

Patru endpoint-uri

Autentificare cu cheie Bearer, JSON la intrare și la ieșire, un singur format de eroare în tot API-ul.

GET/v1/addresses/autocompleteSugestii de adresă pe măsură ce utilizatorul scrie, tolerante la greșeli și la lipsa diacriticelor.Documentație POST/v1/addresses/verifyVerdict, scor de încredere și corecturi pe câmp pentru o adresă liberă sau structurată.Documentație GET/v1/postal-codes/{code}Localitățile, codurile SIRUTA și străzile pentru un cod poștal de șase cifre.Documentație POST/v1/postal-codes/searchCodul poștal pentru o localitate, o stradă și un număr.Documentație

Referința completă a API-ului

Prima cerere

Creează un cont
Intri cu un link primit pe email, cu Google sau cu GitHub. Planul Free nu cere card.
Creează o cheie API
Cheile sunt în dashboard, unde le poți redenumi, roti și revoca.
Fă apelul
Trimite cheia ca token Bearer. Specificația OpenAPI și o colecție Bruno sunt în documentație.

Deschide ghidul de start Specificația OpenAPI Colecția Bruno

curl https://api.posty.ro/v1/addresses/verify \
  -H "Authorization: Bearer $POSTY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"freeform": "str memorandumului 28, cluj"}'

De unde vin datele

Posty folosește surse oficiale românești. Îți spunem ce ediție folosim și unde sunt golurile.

Coduri poștalePoșta Română Infocod

Ediția din mai 2016, cu coduri poștale la nivel de stradă pentru orașe.

LocalitățiSIRUTA (INS)

41 de județe și Bucureștiul, cu municipiile, orașele, comunele, satele și sectoarele lor.

Limitări cunoscuteStrăzi din mediul rural

Majoritatea satelor au un singur cod poștal pentru toată localitatea, deci acolo rezultatele se opresc la nivel de localitate. Străzile apărute după 2016 pot lipsi.