oneapiChangelog
Fiecare modificare care afectează integrarea ta, cu data și versiunea modulului. Modificările incompatibile sunt anunțate cu 90 de zile înainte și marcate distinct.
Un cod CAEN inexistent răspunde 422, nu 404
Pe rutele unde caen e filtru, un cod care nu există în nomenclator era respins cu 404. Pe o listare, 404 înseamnă „resursa nu există" — iar un client care îl prinde, cum se prinde o secțiune fără date, înghițea tăcut „codul ăsta nu există".
- Statusul trece de la 404 la 422 pe cele 34 de rute unde caen e filtru
- Codul scurt rămâne caen_inexistent — cine comută pe el în cod nu simte nimic
- Rutele care au codul în cale (/caen/{cod}/…, /sector/{caen}/…) rămân pe 404: acolo codul e resursa
- O categorie inexistentă iese acum filtru_necunoscut, ca județul și forma juridică, cu explicația în mesaj
Modulul business intră în beta publică
Registrul firmelor e disponibil pentru toate conturile, inclusiv pe planul gratuit.
- Endpoint nou POST /api/business/v1/firme/bulk, până la 100 de coduri per request, de la planul Pro
- Câmp nou caen_principal în răspunsul de firmă
- Adresa de sediu e legată prin cod de modulul locations
- Import zilnic la 04:00 UTC, cu webhook opțional la finalizare
Headere de rate limit pe toate răspunsurile
Până acum, headerele de limită apăreau doar la depășire. Acum sunt prezente pe fiecare răspuns.
- x-ratelimit-limit, x-ratelimit-remaining și x-ratelimit-reset pe toate rutele
- x-request-id adăugat pentru corelarea cu suportul
Ierarhie completă și căutare unificată
Poți cere ierarhia administrativă într-un singur apel, fără să compui mai multe requesturi.
- Parametru include=judet,regiune pe endpoint-ul de localitate
- Endpoint nou GET /api/locations/v1/cauta pentru căutare peste toate tipurile de unități
- Câmp nou parinte ca referință scurtă către unitatea superioară
Redenumirea modulului geo în locations
Modulul geo devine locations, pentru a face loc unor seturi de date administrative din afara României.
- Rutele /geo/v1/* redirecționează către /api/locations/v1/* până la 14 iunie 2027
- Token-urile cu acces la geo funcționează neschimbat pentru locations
- Actualizează URL-urile din integrare până la termenul de mai sus
ETag și răspunsuri condiționate
Un client bine scris consumă acum din cotă doar când datele s-au schimbat efectiv.
- ETag și Cache-Control pe fiecare răspuns
- If-None-Match returnează 304 fără să consume din volumul lunar
Primul modul, disponibil public
Locations iese din beta privată. Contractul de răspuns e considerat stabil de la această versiune.
- 6 endpoint-uri, 13.750 de înregistrări
- Specificație OpenAPI publicată
- Consolă în documentație, cu token-ul contului pre-completat