Versionarea API
Pe această pagină
Scop
API-ul este versionat după dată. Versiunea se alege cu header-ul Billyou-Version.
Pagina în engleză, cu aceleași reguli, este API versioning.
Versiuni acceptate
| Versiune | Rol |
|---|---|
2026-08-01 | Cea mai nouă. Folosește modelul explicit de TVA și discountul pe linie. |
2026-03-01 | Încă acceptată. |
Billyou-Version: 2026-08-01
Când lipsește header-ul
O cerere fără Billyou-Version se rezolvă la 2026-08-01. Nu se folosește versiunea salvată pe cheia de API.
Versiuni retrase
O versiune retrasă este respinsă cu HTTP 400 și errorCode API_VERSION_SUNSET:
{ "success": false, "errorCode": "API_VERSION_SUNSET", "message": "..." }
Webhook-uri
Corpul unui webhook trimite mereu api_version cu valoarea 2026-03-01, inclusiv când apelul API care a produs evenimentul a folosit 2026-08-01. Vezi Webhooks.