4.1.9. Żądania dostępu do punktów końcowych (GET)

Uwaga: Usługa nie jest dostępna w wersji SaaS

Adres URL żądania:

https://<hostname>/ekranapi/AccessRequests/GetEndpointAccessRequests

Wymagane nagłówki:

Nagłówek	Wymagany	Opis
ApiKey	Tak	Służy do uwierzytelnienia żądania.

Przykład nagłówka żądania:

ApiKey: xJ)tsCNcpj)l+]}(@_|lt!t………

Parametry żądania:

Nazwa	Opis	Typ	Format	Wymagane
Endpoint Access Control Access Requests	Zwraca listę żądań dostępu do punktów końcowych, które zostały przetworzone (z pełnymi szczegółami).	GET	–	–
start	Uwzględnia żądania przetworzone po tej dacie i godzinie.	string	`"2021-04-01"` `"2021-04-01T12:00"` `"2021-04-01T12:00:00"`	Nie
end	Uwzględnia żądania przetworzone przed tą datą i godziną.	string	jw.	Nie
count	Liczba żądań do zwrócenia w jednej odpowiedzi. Domyślnie: 1000. Maksymalnie: 1000.	int	Liczba całkowita od 0 do 1000	Nie
afterId	Gdy żądań jest więcej niż 1000, można pobrać kolejną porcję, podając ID ostatniego rekordu z poprzedniego żądania.	int	Dowolna liczba całkowita dodatnia	Nie

Uwagi:

Jeśli nie określono parametrów czasu:
- Jeśli start i end są pominięte, zwracane są wszystkie żądania z całej bazy danych.
- Jeśli start jest pominięty, zwracane są żądania przetworzone przed end.
- Jeśli end jest pominięty, zwracane są żądania przetworzone po start.

Odpowiedź (status 200 = sukces):

{
  "afterId": null,
  "requests": [
    {
      "id": 1,
      "requestedAt": "2023-02-08T13:26:37.763",
      "userName": "windev2210eval\\user",
      "sessionDuration": "00:40:34.4150000",
      "sessionProductiveDuration": "00:28:02.8690000",
      "status": "Approved",
      "remoteIp": "172.31.240.1",
      "statusChangedAt": "2023-02-08T13:32:34.437",
      "statusChangedBy": "admin",
      "statusChangeComment": "approve message"
    },
    {
      "id": 2,
      "requestedAt": "2023-02-08T14:30:55.527",
      "userName": "windev2210eval\\user",
      "sessionDuration": "00:04:15.2660000",
      "sessionProductiveDuration": "00:04:12.2760000",
      "status": "Approved",
      "remoteIp": "172.31.240.1",
      "statusChangedAt": "2023-02-08T14:31:05.187",
      "statusChangedBy": "admin",
      "statusChangeComment": "approve 2 message"
    }
  ]
}

Parametry odpowiedzi:

Nazwa (typ)	Opis
afterId (int)	ID pierwszego żądania w partii wyników (do użycia przy paginacji).
requests (lista)	Lista żądań dostępu do punktów końcowych, zawierająca:
id (int)	ID żądania (techniczne).
requestedAt (date)	Data i godzina złożenia żądania.
userName (string)	Nazwa użytkownika, który złożył żądanie.
sessionDuration (czas)	Całkowity czas trwania sesji.
sessionProductiveDuration (czas)	Czas produktywnej pracy użytkownika podczas sesji.
remoteIp (string)	Adres IP użytkownika składającego żądanie.
status (string)	Status żądania (Approved / Denied / Expired).
statusChangedAt (date)	Data i godzina zmiany statusu żądania.
statusChangedBy (string)	Użytkownik, który zmienił status żądania.
statusChangeComment (string)	Komentarz użytkownika, który zmienił status.

Uwaga: Jeśli zażądano więcej niż 1000 rekordów (count > 1000), zostanie zwrócony kod statusu 400.