# Foaia de parcurs

Ce lipsește ca platforma să fie un SaaS complet pentru clienți externi, în ordinea priorității, și ce s-a făcut deja.

> [!NOTE]
> Prioritățile de mai jos descriu lucruri **care nu există încă**. Nu te baza pe ele într-o integrare până nu apar în [Noutăți](#note-versiune). Ce s-a făcut deja este la final, în „Gata”, cu data.

Starea de pe 12.11.2026.

## Prioritatea 1: o documentație completă a API-ului

| Lucru | De ce |
| --- | --- |
| Specificația OpenAPI pentru toate rutele, publică | azi `GET /v1/openapi.json` cere `admin` și acoperă doar rutele descrise cu scheme |
| Scheme de intrare și de răspuns pe fiecare rută | azi 86 din 307 de rute au tabelele de parametri, corp și răspuns în referință |

## Prioritatea 2: chei API pe mai multe rute

| Lucru | De ce |
| --- | --- |
| Mai multe rute deschise cheilor API | azi o cheie citește doar stocul ([Chei API](#chei-api)); lista crește rută cu rută, după ce fiecare e verificată să decidă accesul doar pe rolul și firma cererii |

## Gata

| Lucru | De când | Unde citești |
| --- | --- | --- |
| Numărul cererii în fiecare răspuns (`x-request-id`) | 11.11.2026 | [Prezentarea API-ului](#api-prezentare--numarul-cererii) |
| Antete de limită pe scrieri (`RateLimit`, `RateLimit-Policy`) și `Retry-After` calculat din fereastră | 11.11.2026 | [Limite](#limite--antetele-de-limita) |
| Format de eroare RFC 9457, la cerere, cu un `cod` canonic care adună mesajele vechi | 11.11.2026 | [Erori](#api-erori--formatul-rfc-9457-la-cerere) |
| `Idempotency-Key` pe 7 rute care creează documente | 11.11.2026 | [Cereri repetate fără dubluri](#idempotenta) |
| Regula de versiuni scrisă | 11.11.2026 | [Versiuni API](#versiuni) |
| Chei API pe firmă (`ilk_…`), cu rol, doar citire implicit, expirare de cel mult 365 de zile și revocare | 12.11.2026 | [Chei API](#chei-api) |
| Webhook-uri semnate după Standard Webhooks, cu reîncercări, rotirea secretului și jurnalul livrărilor | 12.11.2026 | [Webhook-uri](#webhook-uri) |
| Descriere pe fiecare rută (307 din 307) | 12.11.2026 | [Referința API](#api-prezentare) |
| Tabele de parametri, corp și răspuns, cu exemple curl / JavaScript / Python, pe rutele care au schemă | 12.11.2026 | [Referința API](#api-prezentare) |