API-ul public Funciara.com

    Da, există un API HTTP, descris integral într-un document OpenAPI 3.1, la https://funciara.com/openapi.json. O parte din date se pot citi liber, fără cheie și fără cont. Comanda nu poate fi însă plasată programatic — mai jos găsești ce se poate apela și unde se oprește.

    Ce poți citi fără autentificare

    Adresa de bază este https://api.funciara.com, iar fiecare cale începe cu /api. Fără nicio autentificare poți citi:

    • lista județelor și a localităților;
    • dacă este anunțată o întrerupere a serviciilor ANCPI;
    • statistici agregate de livrare;
    • un health check pentru starea API-ului.

    Căile exacte, parametrii și forma răspunsurilor sunt în documentul OpenAPI. API-ul este al Funciara.com; nu este o interfață către sistemele ANCPI.

    Nu emitem chei de API

    Nu există înregistrare, cont de dezvoltator sau program de parteneriat — deci nici cheie pe care să o ceri. Citirile de mai sus funcționează ca atare. O comandă anume se deschide doar cu tokenul emis la crearea ei: cu el vezi starea comenzii și, după ce documentul e gata, linkul către PDF. Nimic altceva nu dă acces la o comandă.

    Comanda nu poate fi plasată programatic

    Ca să plasezi sau să rezervi o comandă îți trebuie în plus un token Cloudflare Turnstile, iar acesta se obține doar din widgetul de pe funciara.com, în browser. Rutele apar în documentul OpenAPI pentru că specificația acoperă tot serviciul, dar un apel automat nu trece de acest pas.

    Formatul răspunsurilor

    Toate răspunsurile sunt JSON. La succes primești success: true și obiectul data. La eroare primești success: false și un obiect error, cu un code pe care îl poți trata programatic și un message. Forma se păstrează și când cererea este oprită înainte să ajungă în aplicație, de exemplu la depășirea limitei.

    Limite pe IP

    Fiecare endpoint are propria limită, scrisă în documentul OpenAPI. Cota rămasă vine în headerele standard de rate limit, iar o cerere respinsă are în plus Retry-After.

    Fără garanții și fără versionare

    Nu avem un angajament public de disponibilitate și nici o politică de versionare: un endpoint se poate schimba sau poate dispărea fără anunț.

    Alte fișiere publice