Ghid rapid

1. Obține un API key

Creează un cont gratuit. Cheia apare o singură dată la creare — salveaz-o într-un secret manager.

2. Fă primul apel

Toate endpointurile cer un header Authorization: Bearer YOUR_API_KEY. Sandbox-ul răspunde la api.sandbox.posty.ro fără limită de quota.

3. Înțelege răspunsul

Răspunsurile sunt JSON, cu un câmp request_id în fiecare răspuns (succes sau eroare). Folosește-l când deschizi un ticket.

{
  "request_id": "req_01HXYZABC123",
  "verdict": "verified",
  "address": {
    "country": "RO",
    "county": "CJ",
    "locality": "Cluj-Napoca",
    "postal_code": "400114",
    "street": "Strada Memorandumului",
    "house_number": "28"
  },
  "confidence": 0.97
}

4. Mergi mai departe

Verifică, completează automat și caută coduri poștale. Restul documentației acoperă fiecare endpoint în detaliu.