Obtenir la connexion par ID

Référence d'API pour récupérer une seule connexion Integration Service par ID, avec l'URL du point de terminaison, les paramètres de chemin et l'exemple de réponse.

Récupère une seule connexion par ID.

Point de terminaison de l’API

GET BaseURL/v1/Connections/{connectionId}

• Utilisez l' URL de base de l'API de connexion pour la plate-forme cloud sur laquelle vous vous trouvez.

En-têtes de requête.

En-tête	Valeur (Value)
Autorisation	Porteur <your-access-token>
X-UIPATH-IDCompte	<tenant>
X-UIPATH-CléDossier	La clé du dossier contenant les connexions

Remplacez toutes les valeurs entre les chevrons <...> par leurs valeurs de cas d’utilisation correspondantes.

Le jeton est celui que vous avez reçu lorsque vous avez autorisé l’application externe. Elle est disponible pendant 1 heure, puis vous devez en générer une nouvelle ou demander un jeton d’actualisation. Consultez Accès à l'API pour savoir comment enregistrer une application externe et obtenir ce jeton.

Important :

Les applications externes doivent cibler un seul dossier, identifié par l’en-tête X-UIPATH-FolderKey . Une requête qui omet l'en-tête renvoie 400 Bad Request.

Variables de chemin d'accès

Variable de chemin d’accès	Type de données	Description	Valeur par défaut
ID de connexion (requis)	string	L'ID de la connexion que vous souhaitez récupérer.	NA

Paramètres de requête

Paramètre de requête	Type de données	Description	Valeur par défaut
InclureConfigurations	boolean	Renvoie la configuration de la connexion. Disponible uniquement pour les appelants qui détiennent l’étendue de lecture de la configuration. Les valeurs secrètes, telles que les clés API et les jetons OAuth, ne sont jamais retournées.	false

Réponses

200 OK

{
  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Name": "My Salesforce connection",
  "Connector": {
    "Key": "uipath-salesforce-sfdc",
    "Name": "Salesforce"
  },
  "Folder": {
    "Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "State": "Connected",
  "IsDefault": true,
  "CreateTime": "2026-09-10T10:20:24.485Z",
  "UpdateTime": "2026-09-10T10:20:24.485Z"
}

400 Requête incorrecte

La requête ne fournissait pas l’en-tête X-UIPATH-FolderKey .

401 Non autorisé

Le jeton d’accès est manquant, a expiré ou n’est pas valide.

403 Forbidden

L’application externe ne possède pas l’étendue requise ou ne dispose pas de l’autorisation Connections.View dans le dossier demandé.

Erreur 404 - Page introuvable

La connexion n’existe pas ou se trouve dans un dossier autre que celui ciblé par la requête. Une connexion en dehors du dossier demandé renvoie 404, et non 403.