# Noutăți

Ce s-a schimbat în platformă și în documentație, în ordine inversă, cu data.

## 12 noiembrie 2026: chei API și webhook-uri

Adăugiri în `v1`, fără nicio schimbare pentru clienții existenți ([Versiuni API](#versiuni)).

- **Chei API pe firmă.** Un Administrator creează chei `ilk_…` cu rol, doar citire implicit și expirare de cel mult 365 de zile; cheia se trimite cu `Authorization: Bearer`. Deocamdată o cheie citește stocul ([Chei API](#chei-api)).
- **Webhook-uri semnate.** Evenimentele `factura.emisa`, `aviz.emis`, `oferta.creata` și `comanda_catering.primita` pleacă spre adresele `https` ale firmei, semnate după Standard Webhooks, cu 10 încercări și jurnal ([Webhook-uri](#webhook-uri)).
- **Referința API.** Fiecare rută are descriere; 107 de rute au tabelele de parametri, corp și răspuns, iar exemplele de cerere vin în curl, JavaScript și Python.

## 11 noiembrie 2026: API

Toate schimbările de mai jos sunt adăugiri în `v1`: un client care nu le folosește primește exact ce primea înainte ([Versiuni API](#versiuni)).

- **Numărul cererii.** Fiecare răspuns are antetul `x-request-id`; un `x-request-id` trimis de client se păstrează.
- **Antete de limită.** Scrierile primesc `RateLimit` și `RateLimit-Policy`; `Retry-After` spune câte secunde mai sunt până se golește fereastra ([Limite](#limite)).
- **Erori RFC 9457, la cerere.** Cu `Accept: application/problem+json`, erorile vin cu `type`, `title`, `status`, `cod` și `id_cerere`; `eroare` rămâne ([Erori](#api-erori)).
- **Cereri repetate fără dubluri.** 9 rute care creează documente acceptă `Idempotency-Key` ([Cereri repetate fără dubluri](#idempotenta)).
- **Regula de versiuni**, scrisă ([Versiuni API](#versiuni)).

## 11 noiembrie 2026: prima ediție

**Prima ediție a documentației.**

- Ghidul: introducere, concepte, primii pași și câte o pagină pentru fiecare modul.
- Administrarea: firme și module, conturi și invitații, roluri și drepturi, securitate, limite.
- Integrările: serverul MCP, OAuth 2.1, fluxul de evenimente, sistemele externe.
- Referința API: 398 de rute în 65 de module, generate direct din codul platformei, cu metoda, accesul și un exemplu pentru fiecare.
- Resursele: comparația cu standardele, foaia de parcurs, glosarul.

> [!TIP]
> Referința API se regenerează din cod, deci rămâne la zi cu platforma. Textele explicative se actualizează odată cu modulele.