Zgodnie z art. 3.4(c) Regulaminu REST API, udzielenie autoryzacji na rzecz Oprogramowania REST API wymaga zastosowania rozwiązań technicznych pozwalających na wiarygodną i jednoznaczną identyfikację Twojej aplikacji.

W związku z powyższym do końca czerwca 2026 skonfiguruj własny, niestandardowy User-Agent.

Co to jest User-Agent?

W kontekście API, User-Agent to nagłówek HTTP, który jest przesyłany przez klienta (aplikację wysyłającą żądanie) do serwera. Nagłówek User-Agent służy aplikacjom zewnętrznym do rozpoznania typu programu klienckiego.

Dlaczego wprowadzamy wymóg implementacji własnego identyfikatora User-Agent?

Chcemy umożliwić naszym systemom monitorującym:

• precyzyjną identyfikację źródła ruchu,
• ścieżkę kontaktu z właścicielem aplikacji bezpośrednio na poziomie analizy logów serwerowych, co minimalizuje ryzyko prewencyjnego blokowania adresu IP aplikacji w przypadku wykrycia niestandardowej aktywności.

Co musisz zrobić?

Skonfiguruj identyfikator User-Agent zgodnie z poniższą strukturą:

• Identyfikacja aplikacji: Pierwszy człon musi zawierać unikalną nazwę systemu/aplikacji oraz aktualną wersję produkcyjną (np. TestApplication/1.1.0). Nazwa musi być spójna z nazwą zarejestrowanej aplikacji.
• Adres URL: Musisz wskazać dedykowaną stronę informacyjną lub repozytorium, gdzie administratorzy zewnętrzni mogą zapoznać się z celem działania aplikacji (np. +https://firma.com/TestApplication-info).

Przykładowa struktura identyfikatora User-Agent:

NazwaAplikacji/Wersja (+AdresURL_Dokumentacji)

Prawidłowo skonfigurowany nagłówek powinien przyjąć postać:

TestApplication/1.1.0 (+https://firma.com/TestApplication-info)