Endpoint-uri

Verificare adrese

Validează o adresă structurată sau freeform și primește un verdict, corecții și un scor de încredere.

POST/v1/addresses/verify

Parametri

Nume	Tip	Obligatoriu	Descriere
`freeform`	string	nu	Adresă liberă, ex. „Str. Mihai Vitezu 12, cluj”.
`street`	string	nu	Numele străzii (alternativă la freeform).
`house_number`	string	nu	Numărul casei. Acceptă formate cu „nr.”, „bl.”, „sc.”.
`locality`	string	nu	Localitate (oraș, comună, sat).
`county`	string	nu	Județ. Acceptă cod (CJ) sau nume.

Exemplu cerere

curl -X POST https://api.posty.ro/v1/addresses/verify \
  -H "Authorization: Bearer psk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "freeform": "Str. Mihai Vitezu 12, cluj" }'

Exemplu răspuns

{
  "verdict": "corrected",
  "confidence": 0.92,
  "address": {
    "street": "Strada Mihai Viteazu",
    "house_number": "12",
    "locality": "Cluj-Napoca",
    "county": "Cluj",
    "county_code": "CJ",
    "postal_code": "400151"
  },
  "corrections": [
    {
      "field": "street_name",
      "from": "Mihai Vitezu",
      "to": "Mihai Viteazu",
      "reason": "diacritic"
    }
  ],
  "request_id": "req_01J9Z8H..."
}