API de gestion de plate-forme

La section relative aux API de gestion de plate-forme présente un aperçu de chaque domaine de gestion de la plate-forme, ainsi que les points de terminaison correspondants.

• Journaux d’audit

• Groupes

• Comptes Robot

• Comptes utilisateur

• Paramètres

• Modèle de message

Récupérer partitionGlobalId pour utiliser l’API

La récupération de partitionGlobalId constitue une étape critique lorsque l’API est utilisée dans le cadre de la gestion des utilisateurs et des groupes. Ce paramètre représente l’ID de l’organisation pour laquelle vous avez l’intention de gérer les comptes. Suivez ce guide afin de découvrir différentes méthodes pour récupérer votre partitionGlobalId.

Comprendre partitionGlobalId

Le paramètre partitionGlobalId doit être inclus dans le corps de la requête lors des requêtes d’API. Il identifie de manière unique l’organisation que vous gérez.

Si vous récupérez ou utilisez ce paramètre par erreur, un message d’erreur semblable à celui-ci s’affichera :'{"errors":{"partitionGlobalId":["The value 'DatacomGroup' is not valid."]} '. Cela indique que la valeur partitionGlobalId saisie n’est pas valide.

Méthode 1 : récupérer partitionGlobalId à partir de l’URL

Votre partitionGlobalId est intégré à l’URL affichée lorsque vous vous connectez.

Prenons par exemple l’URL suivante : https://baseURL/tenant/portal_/cloudrpa?organizationId=xxxxxx&ecommerceRedirect=false&isAuth0=true, xxxxx est le partitionGlobalId. Cependant, il peut être difficile à saisir, car il est possible que l’URL se charge trop rapidement.

Méthode 2 : utiliser des outils de développeur pour récupérer partitionGlobalId

Pour contourner ce problème de chargement trop rapide, procédez comme suit :

1. Ouvrez les outils de développement de votre navigateur Web avant de vous connecter. Sur Windows et Linux, vous pouvez ouvrir les outils de développement à l’aide du raccourci clavier Ctrl + Maj + J. Sur Mac, vous pouvez ouvrir les outils de développement à l’aide du raccourci clavier Cmd + Option + J.

2. Accédez à l’onglet Réseau et activez l’enregistrement.

   

3. Connectez-vous à {baseURL_vanilla} et sélectionnez le locataire souhaité.

4. Une fois la page entièrement chargée, revenez aux outils de développement dans l’onglet Réseau.

5. Examinez les demandes effectuées pendant le chargement de la page. Recherchez une demande, par exemple la demande d’API Paramètres.

6. Dans l’ URL de demande de cette requête, vous trouverez partitionGlobalId suivi d’un ID. Cet ID est votre partitionGlobalId ainsi que la valeur à utiliser dans vos appels d’API.