Wersje API i wycofywanie

Stan

Obecna wersja: v1. Nic nie jest wycofywane i żadna data wyłączenia nie jest ustalona.

Wersja jest częścią adresu: obecne API działa pod /api/v1.
Zmianę, która psuje zgodność, wydajemy pod nowym adresem (/api/v2). Pola dodane do odpowiedzi nie psują zgodności i trafiają do obecnej wersji.
Wycofanie wersji ogłaszamy na tej stronie co najmniej 90 dni przed jej wyłączeniem.
Przez te 90 dni stara wersja działa dalej, a każda jej odpowiedź niesie nagłówek Deprecation (RFC 9745) z datą ogłoszenia i Sunset (RFC 8594) z datą wyłączenia.
Każda odpowiedź pod /api/v1 ma nagłówek Link z rel="deprecation" wskazujący tę stronę, także gdy nic nie jest wycofywane.