Versiuni
/v1 e contractul major.
/v1 fixează contractul major. Nu scoatem câmpuri și nu schimbăm tipul unui câmp existent fără /v2 — adăugarea de câmpuri noi e considerată compatibilă.
O schimbare incompatibilă va avea o perioadă minimă de migrare de șase luni, cu ambele versiuni disponibile.
Endpoint-urile webhook (planificate) păstrează versiunea payload-ului în apiVersion, separat de versiunea rutei care le-a înregistrat.