Documentatie API

RoAPI ofera acces la informatii despre firme romanesti printr-un API REST simplu si rapid. Datele sunt sincronizate zilnic de la ANAF cu fallback automat.

Base URL:

https://api.roapi.ro/v1

Autentificare

Toate request-urile necesita un API Key transmis in header-ul Authorization:

Authorization: Bearer YOUR_API_KEY

Poti genera si gestiona API Keys din contul tau.

API Firme

Cauta firma dupa CUI

GET /v1/firme/{cui}

Parametri:

Parametru	Tip	Descriere
`cui`	integer	Codul Unic de Identificare al firmei

Exemplu:

curl -X GET "https://api.roapi.ro/v1/firme/12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Format raspunsuri

Toate raspunsurile sunt in format JSON:

{
  "success": true,
  "data": {
    "cui": 12345678,
    "denumire": "EXEMPLU SRL",
    "adresa": "Str. Exemplu Nr. 1, Bucuresti",
    "stare": "ACTIVA",
    "tva": true,
    "cod_caen": "6201"
  }
}

Coduri eroare

Cod	Descriere
`200`	Succes
`401`	API Key invalid sau lipseste
`403`	API Key inactiv sau limita depasita
`404`	Firma nu a fost gasita
`429`	Rate limit depasit
`500`	Eroare server

Rate limiting

Limita de request-uri depinde de planul tau. Header-urile de raspuns includ:

Header	Descriere
`X-RateLimit-Limit`	Limita totala per luna
`X-RateLimit-Remaining`	Request-uri ramase
`X-RateLimit-Reset`	Timestamp cand se reseteaza limita