Abonnieren

UiPath Data Service

Die Anleitung zum UiPath Data Service

API-Zugang

Überblick


Mit der Open API des Data Service können Sie Ressourcen des UiPath Data Service aus einer externen Anwendung Ihrer Wahl verwalten. Dies geschieht, indem Sie die externe App über das Framework Oauth 2.0 autorisieren, ohne irgendwelche Anmeldeinformationen freigeben zu müssen.

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

API-Berechtigungen


Um die OpenAPI des Data Service verwenden zu können, müssen Sie der externen Anwendung API-Berechtigungen gewähren. Diese API-Berechtigungen werden als Scopes bezeichnet und es gibt drei Typen davon für den Data Service:

  • DataService.Schema.Read – Mit diesem Benutzer-Scope kann Ihre externe App das Data Service-Schema Ihres Mandanten lesen, und es ist von den Berechtigungen des Benutzers abhängig.
  • DataService.Data.Read – Mit diesem Benutzer-Scope kann Ihre externe App die Data Service-Daten Ihres Mandanten lesen, und es ist von den Berechtigungen des Benutzers abhängig.
  • DataService.Data.Write – Mit diesem Benutzer-Scope kann Ihre externe App die Data Service-Daten Ihres Mandanten bearbeiten, indem sie neue Daten löscht, aktualisiert oder erstellt, und es ist von den Berechtigungen des Benutzers abhängig.

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

OpenAPI-Spezifikation herunterladen


Wenn Ihre externe Anwendung und die Benutzerberechtigungen eingerichtet sind, laden Sie die OpenAPI-Spezifikation von den Data Service-Daten Ihres Mandanten herunter. Navigieren Sie dazu zum Menü oben rechts auf der Registerkarte ihres Mandanten mit der Bezeichnung Data Service > API-Zugang > OpenAPI-Datei herunterladen (JSON).

Dadurch erhalten Sie die OpenAPI 3.0-Spezifikationen der Data Service-Entitäten Ihres Mandanten im JSON-Format. Wenn Sie auf OpenAPI-Link kopieren klicken, wird der API-Endpunkt kopiert, der die Data Service OpenAPI-Spezifikation des Mandanten generiert.

Autorisieren der API-Aufrufe


Gewähren Sie Ihrer externen Anwendung, die Data Service OpenAPI zu verwenden, indem Sie ein Zugriffstoken für Ihre externe Anwendung erstellen. Verwenden Sie die App-ID und den Geheimen App-Schlüssel, die bei der Registrierung der externen Anwendung generiert wurden. Die Autorisierungsmethode hängt vom Typ der Anwendung ab (vertrauliche oder nicht vertrauliche Anwendung).

Learn more about the authorization methods for external apps.

API-Endpunkte


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.

Ein Data Service API-Endpunkt hat die folgende Syntax:
HTTP method + BaseURL + The resource category + The Data Service entity + The Operation + Path variables and query parameters

Beispiel für eine Data Service-Entität


Um jeden API-Anforderungs-/Antworttext zu beschreiben, verwenden wir die im Data Service erstellten Entitätsfelder der Olympische Spiele. Während wir den exemplarischen Endpunkt dokumentieren, z. B. Get Entity Records, enthält Ihr Endpunkt den genauen Namen der Entität (z. B. Get Olympics Records). Die Antwort- und Anforderungstexte enthalten alle Felder aus Ihrer Entität und kopieren die Struktur der Entität.

Sehen wir uns nun jeden Endpunkt genauer an und erfahren Sie, wie Sie diese nutzen können.

Vor ungefähr einem Jahr aktualisiert


API-Zugang


Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.