• Site Logo, Articulate

Recherche d'articles

Sélectionnez un produit

Répertoire d'assistance de null

Explorez tous les articles de null (Last Updated )

Aucun article trouvé.

Résultats de recherche

Aucun article trouvé.

Reach 360 : API pour les gestionnaires et la gestion des groupes

Article mis à jour pour la dernière fois le 22 avr. 2025

Points de terminaison

  • GET /users/{userId}/managing-groups- liste les groupes gérés par un responsable
  • GET /groups/{groupId}/managers- lister les responsables d'un groupe

Répertorier les groupes gérés par un responsable

GET /users/{userId}/managing-groups

Paramètres de demande (chaîne de requête)

  • limit(entier, facultatif) - le nombre maximum de résultats à renvoyer dans une seule réponse (voir Pagination) ; doit être compris entre 1 et 100 (50 par défaut)

Exemple de réponse

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

Codes d'erreur spécifiques au point de terminaison :

  • user_not_found- Impossible de répertorier les groupes du responsable car l'utilisateur n'existe pas
  • invalid_user_role- Impossible de répertorier les groupes du responsable car l'utilisateur n'est pas un responsable

Répertorier les managers d'un groupe

GET /groups/{groupId}/managers

Paramètres de demande (chaîne de requête)

  • limit(entier, facultatif) - le nombre maximum de résultats à renvoyer dans une seule réponse (voir Pagination) ; doit être compris entre 1 et 100 (50 par défaut)

Exemple de réponse

{
  "groupUrl": "<http://api.rise.com/groups/example-group-id>",
  "managers": [
    {
      "id": "example-user-id-1",
      "email": "foo@example.com",
      "groupsUrl": "<https://api.rise.com/users/example-user-id-1/groups>",
      "managingGroupsUrl": "<https://api.rise.com/users/example-user-id-1/managing-groups>",
      "reportingGroupsUrl": null,
      "role" :"manager",
      "firstName": "Example Group Manager",
      "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": "<https://api.rise.com/users/example-user-id-2/managing-groups>",
			"reportingGroupsUrl": null,
      "role": "manager",
      "firstName": "Example Group Manager 2",
      "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>"
}

Codes d'erreur spécifiques au point de terminaison :

  • group_not_found- Impossible de répertorier les gestionnaires car le groupe n'existe pas