Endpoint-uri

Autocomplete

Sugestii de adresă în timp real, toleranță la greșeli și diacritice.

GET/v1/addresses/autocomplete

Parametri query

Nume	Tip	Obligatoriu	Descriere
`q`	string	da	Textul tastat de utilizator. Minimum 2 caractere.
`limit`	integer	nu	Număr maxim de sugestii (1-10). Default 5.
`county`	string	nu	Filtrare după județ (cod sau nume).

Exemplu cerere

curl https://api.posty.ro/v1/addresses/autocomplete?q=Mihai+Vit \
  -H "Authorization: Bearer psk_live_xxx"

Exemplu răspuns

{
  "suggestions": [
    {
      "text": "Strada Mihai Viteazu 12, Cluj-Napoca, Cluj",
      "locality": "Cluj-Napoca",
      "county": "Cluj",
      "postal_code": "400151"
    },
    {
      "text": "Strada Mihai Viteazu, Cluj-Napoca, Cluj",
      "locality": "Cluj-Napoca",
      "county": "Cluj",
      "postal_code": "400xxx"
    }
  ],
  "request_id": "req_01J9Z8H..."
}