Accès à l’API

Vue d'ensemble (Overview)

Ouvrir l'API (Open API) de Data Service vous permet de gérer les ressources UiPath Data Service à partir d'une application externe de votre choix en vous permettant d'autoriser l'application externe sans partager d'informations d'identification via le cadre d'autorisation Oauth 2.0.

Learn how to register the external application in UiPath Automation Suite.

Autorisations d'API

Pour utiliser OpenAPI de Data Service, vous devez accorder des autorisations d'API à l'application externe. Ces autorisations d'API sont nommées « étendues », et il en existe trois types pour Data Service :

• DataService.Schema.Read : cette étendue d'utilisateur (User Scope) permet à votre application externe de lire le schéma Data Service de votre locataire, et dépend des autorisations de l'utilisateur.
• DataService.Data.Read : cette étendue d'utilisateur (User Scope) permet à votre application externe de lire les données Data Service de votre locataire, et dépend des autorisations de l'utilisateur.
• DataService.Data.Write : cette étendue d'utilisateur (User Scope) permet à votre application externe de modifier les données Data Service de votre locataire en supprimant, en mettant à jour ou en créant de nouvelles données, et dépend des autorisations de l'utilisateur.

Learn more about the user roles and permissions in Data Service.

Télécharger la spécification OpenAPI

À l'aide de votre application externe et des autorisations utilisateur définies, téléchargez la spécification OpenAPI des données Data Service de votre locataire. Pour ce faire, accédez au menu en haut à droite de l'onglet Data Service du locataire > Accès à l'API (API Access) > Télécharger le fichier OpenAPI (JSON) [Download OpenAPI file (JSON)].

This will get you the OpenAPI 3.0 specifications of your tenant's Data Service entities, in JSON format. Clicking **Copy OpenAPI link** copies the API endpoint that generates the tenant's Data Service OpenAPI specification.

Autoriser les appels d'API

Autorisez votre application externe à utiliser Data Service OpenAPI en créant un jeton d'accès pour votre application externe. Utilisez l'identifiant de l'application et la clé secrète de l'application générés lors de l'enregistrement de l'application externe. Le mode d'autorisation dépend du type d'application (confidentiel ou non confidentiel).

En savoir plus sur les méthodes d'autorisation pour les applications externes.

Points de terminaison de l’API

OAuth2.0 authorization framework helps you generate a access token that allows your external application to make REST API calls to Data Service endpoints, for a limited time (one hour). To continue calling the APIs you need to generate a new access token or request a refresh token.

Les points de terminaison d'API Data Service présentent la syntaxe suivante :

• Méthode HTTP + BaseURL + La catégorie de ressource + L'entité Data Service + L'Opération + Les variables de chemin d'accès et les paramètres de recherche

  

  Important :

  In the Automation Suite-deployed Data Service, each active connection can have only one active file upload API call.

  Pour éviter de rencontrer cette limitation de l'API, assurez-vous de transmettre l'en-tête Connection: close dans votre requête.

  Exemple d'entité de Data Service

  Pour décrire chaque corps de recherche/réponse API, nous utilisons les champs d'entité Jeux olympiques (Olympics) créés dans Data Service. Lorsque nous documentons le point de terminaison générique, tel que Get Entity Records, votre point de terminaison contient le nom exact de votre entité (par exemple, Get Olympics Records). Les corps de réponse et de demande incluent tous les champs de votre entité, reproduisant ainsi la structure de l'entité.

  

  Découvrons chaque point de terminaison et voyons comment les utiliser à bon escient.