Introducere

Datero expune date publice românești — firme, coduri CAEN, județe și localități, curs valutar BNR — prin două canale cu comportament identic: un API REST și un server MCP. Aceeași operație are același input, output, cost și aceleași limite pe ambele canale.

• Base URL: https://api.datero.ro
• Format: JSON (request și răspuns), erori RFC 7807
• Specificație: OpenAPI 3.1 · referință interactivă
• MCP: https://api.datero.ro/mcp (Streamable HTTP)

Primul apel în 60 de secunde

Datele de referință (CAEN, localități, curs valutar) sunt gratuite și nu cer cheie — poți încerca direct din terminal:

curl "https://api.datero.ro/v1/fx-rates?currency=EUR,USD"

Pentru datele de firme folosește o cheie API (apelurile anonime merg, dar doar pentru testare rapidă — vezi „Acces anonim" mai jos):

1. Creează-ți un cont — primești automat planul Free (1.000 credite/lună).
2. Generează o cheie în dashboard → Chei API.
3. Trimite cheia în headerul Authorization:

curl "https://api.datero.ro/v1/companies/2816464" \
  -H "Authorization: Bearer dat_live_CHEIA_TA"

Cum citești documentația

Fiecare endpoint are propria pagină cu parametri, exemple reale de request/răspuns și un playground live în care poți rula apeluri cu cheia ta, direct din browser. Navighează din bara laterală sau pornește de la autentificare și credite și limite.

Pentru agenți AI

Documentația este publicată și în formate machine-readable: llms.txt, llms-full.txt, fiecare pagină ca markdown curat (adaugă .md la URL) și OpenAPI cu extensii x-credits-cost / x-mcp-tool pe fiecare operație. Iar prin MCP, un agent folosește API-ul fără să scrie cod.