# Wersje API i wycofywanie: Nauka Gryzie

## Stan

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

## Zasady

- 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.

## Zobacz też

- [Dla programistów](https://naukagryzie.pl/developers)
- [Spis adresów API](https://naukagryzie.pl/api/v1)
- [Ta strona w HTML](https://naukagryzie.pl/developers/deprecation)