• Site Logo, Articulate

Wyszukiwanie artykułów

Wybierz produkt

Katalog pomocy dla null

Przeglądaj wszystkie artykuły null (Last Updated )

Nie znaleziono artykułów.

Wyniki wyszukiwania

Nie znaleziono artykułów.

Reach 360 API: Interfejs API dla reporterów i grup raportowania

Artykuł zaktualizowany ostatnio dnia 22 kwi 2025

Punkty końcowe

  • GET /users/{userId}/reporting-groups- wypisz, dla jakich grup raportuje reporter
  • GET /groups/{groupId}/reporters- wymienić reporterów grupy

Lista grup zgłaszanych przez reportera

GET /users/{userId}/reporting-groups

Parametry żądania (ciąg zapytania)

  • limit(liczba całkowita, opcjonalna) - maksymalna liczba wyników do zwrócenia w pojedynczej odpowiedzi (patrz Paginacja); musi wynosić od 1 do 100 (domyślnie 50)

Przykładowa odpowiedź

{
  "userUrl": "<https://api.rise.com/users/example-user-id-1>",
  "groups": [
    {
      "id": "example-group-id-1",
      "membersUrl": "<https://api.rise.com/groups/example-group-id-1/users>",
      "managersUrl": "<https://api.rise.com/groups/example-group-id-1/managers>",
      "reportersUrl": "<https://api.rise.com/groups/example-group-id-1/reporters>",
      "name": "Example Group",
      "url": "<https://api.rise.com/groups/example-group-id-1>"
    }, ...
  ],
  "nextUrl": "<https://url-for-next-page-of-results>"
}

Kody błędów specyficzne dla punktu końcowego:

  • user_not_found- nie można wyświetlić listy grup reportera, ponieważ użytkownik nie istnieje
  • invalid_user_role- nie można wyświetlić listy grup reporterów, ponieważ użytkownik nie jest reporterem

Lista reporterów grupy

GET /groups/{groupId}/reporters

Uwaga: obejmuje użytkowników, którzy również zgłaszają się w grupie Wszyscy

Parametry żądania (ciąg zapytania)

  • limit(liczba całkowita, opcjonalna) - maksymalna liczba wyników do zwrócenia w pojedynczej odpowiedzi (patrz Paginacja); musi wynosić od 1 do 100 (domyślnie 50)

Przykładowa odpowiedź

{
  "groupUrl": "<http://api.rise.com/groups/example-group-id>",
  "reporters": [
    {
      "id": "example-user-id-1",
      "email": "foo@example.com",
      "groupsUrl": "<https://api.rise.com/users/example-user-id-1/groups>",
      "managingGroupsUrl": null,
      "reportingGroupsUrl": "<https://api.rise.com/users/example-user-id-1/reporting-groups>",
      "role" :"reporter",
      "firstName": "Example Group Reporter",
      "lastName": "Example Last Name",
      "lastActiveAt": "2021-10-28T20:39:52.659Z",
      "learnerReportUrl": "<https://api.rise.com/reports/learners/example-user-id-1>",
      "url": "<https://api.rise.com/users/example-user-id-1>"
    },
    {
      "id": "example-user-id-2",
      "email": "bar@example.com",
      "groupsUrl": "<https://api.rise.com/users/example-user-id-2/groups>",
      "managingGroupsUrl": null,
      "reportingGroupsUrl": "<https://api.rise.com/users/example-user-id-2/reporting-groups>",
      "role": "reporter",
      "firstName": "Example Everyone Reporter",
      "lastName": "Example Last Name",
      "lastActiveAt": "2021-10-28T20:39:52.659Z",
      "learnerReportUrl": "<https://api.rise.com/reports/learners/example-user-id-2>",
      "url": "<https://api.rise.com/users/example-user-id-2>"
    }, ...
  ],
  "nextUrl": "<https://url-for-next-page-of-results>"
}

Kody błędów specyficzne dla punktu końcowego:

  • group_not_found- nie mogę wymienić reporterów, ponieważ grupa nie istnieje

 

Reach 360 API: Interfejs API dla reporterów i grup raportowania