API & Integrări tehnice
Ghid pentru integrarea API-ului BizRadar în aplicația ta: autentificare, endpoint-uri, limite și bune practici.
Cum obțin o cheie API?
Cheia API se generează după crearea unui cont și selectarea unui plan de abonament. Din panoul de administrare, mergi la secțiunea "API Keys" unde poți genera, vizualiza și gestiona cheile tale. Fiecare cheie poate fi configurată cu limite specifice de rate.
Ce endpoint-uri sunt disponibile?
API-ul BizRadar v4 oferă endpoint-uri pentru: căutare companii, detalii firmă (după CUI sau slug), date financiare anuale, topuri (naționale, județene, pe localitate), nomenclatoare geografice (județe, localități) și coduri CAEN. Consultă documentația completă la /api-docs.
Ce format de date returnează API-ul?
Toate răspunsurile API sunt în format JSON cu encoding UTF-8. API-ul suportă paginare, filtrare și sortare prin parametri de query string. Fiecare răspuns include un obiect cu metadate (total rezultate, pagină curentă) și un array cu datele solicitate.
Care sunt limitele de rate (rate limiting)?
Limitele de rate depind de planul de abonament: planul gratuit permite 10 cereri/zi, Pro 4.000 credite/lună, iar Enterprise are limite personalizate. Header-ele de răspuns includ informații despre limitele rămase. Depășirea limitelor returnează statusul HTTP 429.
API-ul suportă bulk requests?
Endpoint-ul de căutare permite returnarea a până la 100 de rezultate per pagină. Pentru interogări mai complexe sau date în volum mare, recomandăm planul Enterprise cu acces la export-uri batch. Contactează echipa de vânzări pentru detalii.
Ce fac dacă primesc erori de la API?
Verifică: 1) Cheia API este validă și activă; 2) Nu ai depășit limita de cereri; 3) Parametrii sunt corect formatați; 4) Endpoint-ul există. Erorile returnează un obiect JSON cu codul de eroare și un mesaj descriptiv. Pentru probleme persistente, contactează suportul tehnic.
Pot folosi API-ul pentru aplicații comerciale?
Da, conform termenilor planului tău de abonament. Planul Professional permite integrare în aplicații interne, iar planul Enterprise permite redistribuirea datelor conform contractului. Este obligatorie menționarea sursei datelor (BizRadar) conform termenilor de utilizare.