Obtenir un compte robot spécifique

Renvoie des informations sur un compte Robot, en fonction de l'organisation et de l'ID du compte Robot.

Point de terminaison de l’API

GET https://{yourDomain}/{organizationName}/identity/api/RobotAccount/{partitionGlobalId}/{robotAccountId}

Étendues

Nécessite les étendues suivantes :

• PM.RobotAccount
• PM.RobotAccount.Read

En-têtes de requête.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Remarque : pour obtenir le {access_token}, assurez-vous de vous authentifier via l'une des méthodes décrites ici.

Paramètres de chemin d'accès

Paramètre du chemin d'accès	Type de données	Description
partitionGlobalId (requis)	Chaîne de caractères (string)	L'ID de l'organisation contenant le groupe souhaité.
robotAccountID (requis)	Chaîne de caractères (string)	L'ID du compte Robot que vous souhaitez récupérer.

Réponses

200 OK

Les informations de compte de robot indiquées sont renvoyées, telles que le nom, l'heure de création et les ID de groupe dont le compte fait partie.

Exemple de requête

Supposons que vous ayez rassemblé toutes les informations nécessaires pour créer l'appel d'API.

• Votre {baseURL} est : https://{yourDomain}/{organizationName}/{tenantName}/
• Votre {access_token} est : 1234 (pour des considérations de longueur).
• Le {partitionGlobalId} est : magic-7
• Le {robotAccountID} est : 33-ab

L’appel devrait ressembler à l'exemple ci-dessous (cURL) :

curl --location --request GET 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/RobotAccount/magic-7/33-ab' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'

Voici la réponse pour un appel réussi :

{
    "id": "33-ab",
    "name": "Bot3",
    "displayName": "Bot3",
    "creationTime": "2021-10-19T14:25:01.6574988",
    "lastModificationTime": "2021-10-19T14:25:01.6574988",
    "groupIds": [
       "4d161738-7204", "ce684f6f-5af3"
    ]
}