• Site Logo, Articulate

Door artikelen bladeren

Selecteer een Product

Supportdirectory van null

Bekijk alle artikelen van null. (Last Updated )

Geen artikelen gevonden.

Zoekresultaten

Geen artikelen gevonden.

Reach 360 API: API voor verslaggevers en rapportagegroepen

Artikel laatst bijgewerkt 22 apr 2025

Eindpunten

  • GET /users/{userId}/reporting-groups- vermeld voor welke groepen een verslaggever rapporteert
  • GET /groups/{groupId}/reporters- maak een lijst van de verslaggevers van een groep

Maak een lijst van groepen die een verslaggever rapporteert

GET /users/{userId}/reporting-groups

Verzoekparameters (queryreeks)

  • limit(geheel getal, optioneel) - het maximale aantal resultaten dat in één antwoord kan worden geretourneerd (zie Paginering); moet tussen 1 en 100 liggen (standaard 50)

Voorbeeldreactie

{
  "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>"
}

Endpoint-specifieke foutcodes:

  • user_not_found- kan de groepen van verslaggevers niet weergeven omdat de gebruiker niet bestaat
  • invalid_user_role- kan de groepen van verslaggevers niet weergeven omdat de gebruiker geen verslaggever is

Maak een lijst van de verslaggevers van een groep

GET /groups/{groupId}/reporters

Opmerking: omvat gebruikers die ook rapporteren over de groep Iedereen

Verzoekparameters (queryreeks)

  • limit(geheel getal, optioneel) - het maximale aantal resultaten dat in één antwoord kan worden geretourneerd (zie Paginering); moet tussen 1 en 100 liggen (standaard 50)

Voorbeeldreactie

{
  "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>"
}

Endpoint-specifieke foutcodes:

  • group_not_found- kan geen verslaggevers vermelden omdat de groep niet bestaat