Obtenir des connexions

Référence de l'API pour répertorier les connexions Integration Service dans un dossier, avec l'URL du point de terminaison, les en-têtes requis et un exemple de réponse.

Récupère les connexions dans un dossier.

Point de terminaison de l’API

GET BaseURL/v1/Connections

• 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.

La feuille <your-access-token> est celle que vous avez reçue 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 ou qui définit allFolders sur true renverra 400 Bad Request.

Paramètres de requête

Paramètre de requête	Type de données	Description	Valeur par défaut
Tous les dossiers	boolean	Non pris en charge pour les applications externes. Le définir sur true renvoie 400 Bad Request.	false

Réponses

200 OK

Renvoie les connexions dans le dossier demandé. Les réponses à une application externe excluent le propriétaire de la connexion, l'ID d'instance de l'élément, l'intervalle d'interrogation et l'indicateur « Apportez-votre-propre-application ».

[
  {
    "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 ou définissait allFolders sur true Les applications externes doivent cibler un dossier par requête.

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é.