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.
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. 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); 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 |
Antete de limită pe scrieri (RateLimit, RateLimit-Policy) și Retry-After calculat din fereastră | 11.11.2026 | Limite |
Format de eroare RFC 9457, la cerere, cu un cod canonic care adună mesajele vechi | 11.11.2026 | Erori |
Idempotency-Key pe 7 rute care creează documente | 11.11.2026 | Cereri repetate fără dubluri |
| Regula de versiuni scrisă | 11.11.2026 | Versiuni API |
Chei API pe firmă (ilk_…), cu rol, doar citire implicit, expirare de cel mult 365 de zile și revocare | 12.11.2026 | Chei API |
| Webhook-uri semnate după Standard Webhooks, cu reîncercări, rotirea secretului și jurnalul livrărilor | 12.11.2026 | Webhook-uri |
| Descriere pe fiecare rută (307 din 307) | 12.11.2026 | Referința API |
| Tabele de parametri, corp și răspuns, cu exemple curl / JavaScript / Python, pe rutele care au schemă | 12.11.2026 | Referința API |
A fost utilă pagina?Mulțumim pentru răspuns.