Uwierzytelnianie KSeF

POST /auth/{environment}

Logowanie (nawiązywanie połączenia) do KSeF przy użyciu certyfikatu powiązanego z kontem użytkownika. Inicjuje sesję interaktywną i zwraca tokeny dostępu.

Parametry ścieżki

Parametr	Typ	Wymagany	Opis
environment	string	✅	test, demo lub prod

Odpowiedź 200

{
  "accessToken": {
    "token": "eyJ...",
    "validUntil": "2026-04-18 23:00:00"
  },
  "refreshToken": {
    "token": "eyJ...",
    "validUntil": "2026-04-18 23:00:00"
  },
  "environment": "test",
  "nip": "9570429696",
  "subjectName": "C=PL, O=Firma XYZ, CN=user@example.com",
  "shortName": "user@example.com",
  "authenticatedAt": "2026-04-11 23:00:00"
}

Pole	Typ	Opis
accessToken	object	Token dostępu KSeF z datą ważności
refreshToken	object	Token odświeżania KSeF (może być null)
environment	string	Użyte środowisko KSeF
nip	string	NIP firmy
subjectName	string	Pełna nazwa podmiotu z certyfikatu
shortName	string	Skrócona nazwa podmiotu
authenticatedAt	string	Data uwierzytelnienia

Kody błędów

Kod	Opis
401	Brak lub błędne dane uwierzytelniające (Basic Auth)
403	Brak wymaganej roli (admin lub technical)
404	Brak aktywnego certyfikatu dla danego środowiska
500	Błąd serwera lub KSeF