# 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](/docs/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](/docs/erori)
- **Specificație:** [OpenAPI 3.1](https://api.datero.ro/openapi.json) · [referință interactivă](https://api.datero.ro/docs)
- **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:

```bash
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](/login) — primești automat planul Free (1.000 credite/lună).
2. Generează o cheie în [dashboard → Chei API](/dashboard/keys).
3. Trimite cheia în headerul `Authorization`:

```bash
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](/docs/autentificare) și [credite și limite](/docs/credite-si-limite).

## Pentru agenți AI

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