- Erste Schritte
- Lizenzierung
- Einstellung und Konfiguration (Setup and Configuration)
- Verwenden von Data Service
- Referenz (Reference)
- Beispiele und Tutorials
API-Zugang
Mit der Open API des Data Service können Sie UiPath® Data Service-Ressourcen 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.
Erfahren Sie, wie Sie in der UiPath® Automation Cloud die externe Anwendung registrieren können .
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.
Erfahren Sie mehr über die Benutzerrollen und Berechtigungen im Data Service.
Sobald Sie die Berechtigungen für Ihre externe Anwendung und Ihre Benutzer festgelegt haben, laden Sie die OpenAPI-Spezifikation von Ihren Data Service-Mandantendaten herunter:
-
Klicken Sie auf der Seite Data Service auf API-Zugang und wählen Sie dann OpenAPI-Datei herunterladen (JSON) aus.
Bei diesem Vorgang werden die OpenAPI 3.0-Spezifikationen Ihrer Data Service-Mandantenentitäten im JSON-Format heruntergeladen.
Wenn Sie auf OpenAPI-Link kopieren klicken, wird der API-Endpunkt kopiert, der die Data Service OpenAPI-Spezifikation des Mandanten generiert.
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).
Erfahren Sie mehr über die Autorisierungsmethoden für externe Apps.
Das Autorisierungsframework OAuth2.0 unterstützt Sie dabei, ein Zugriffstoken zu generieren, mit dem Ihre externe Anwendung REST API-Aufrufe an Data Service-Endpunkte für eine begrenzte Zeit (eine Stunde) ausführen kann.
Um die APIs weiterhin aufrufen zu können, müssen Sie ein neues Zugriffstoken generieren oder ein Aktualisierungstoken anfordern.
Ein Data Service API-Endpunkt hat die folgende Syntax:
-
HTTP-Methode + BasisURL + Die Ressourcenkategorie + Die Data Service-Entität + Der Vorgang + Pfadvariablen und Abfrageparameter
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.Im Data Service API-Leitfaden erfahren Sie mehr über jeden Endpunkt und erfahren, wie Sie ihn nutzen können.