URL-Struktur des API-Endpunkts

URL-Struktur für die Erstellung von Test-Cloud-API-Anforderungen, einschließlich Basis-URLs für Test Cloud, Test Cloud Public Sector und Test Cloud Dedicated.

In diesem Abschnitt erfahren Sie, wie Sie API-Anforderungen anhand der URL-Struktur von UiPath®-Endpunkten konstruieren können.

Basis-URL

Die Basis-URL ist der Ausgangspunkt für alle API-Anforderungen. Sie dient als Grundlage für die Erstellung der Endpunkt-URL. Je nach verwendeter Cloud-Plattform verwenden Sie die entsprechende Basis-URL:

• Test Cloud: https://cloud.uipath.com
• Test Cloud – öffentlicher Sektor: https://govcloud.uipath.us
• Test-Cloud dediziert: https://<customURL>.dedicated.uipath.com

Einstiegspunkt

api – Bezeichnet den Einstiegspunkt zu den Verwaltungsressourcen der API-Plattform, z. B. ​/api​/Group​/

Ressourcenpfad

Der Ressourcenpfad gibt die genaue Ressource oder den auszuführenden Vorgang an. Es können Schlüsselwörter wie Group, RobotAccount oder Setting enthalten sein, je nach Zweck der Anforderung.

Pfadparameter

Pfadparameter werden verwendet, um dynamische Werte an einen API-Endpunkt zu übergeben. Diese Werte helfen bei der Identifizierung bestimmter Ressourcen, die für die API-Anforderung relevant sind. Beispiel: ​/Group​/{partitionGlobalId}​/{groupId}.

partitionGlobalId – Die ID der Organisation.

groupId – Die ID der Gruppe.

Abfrageparameter

Abfrageparameter sind zusätzliche Parameter, die an die URL angehängt werden, um mehr Kontext oder Filter für die angeforderten Daten bereitzustellen. Ihnen geht häufig ein ? -Symbol voraus und werden durch & -Symbole getrennt. Beispielsweise können Sie Abfrageparameter verwenden, um Filterkriterien oder Paginierungsanweisungen anzugeben.

Beispiel

Nimmt man alle Komponenten zusammen, könnte eine URL für eine organisationsspezifische Ressource so aussehen: https://cloud.uipath.com/{organizationName}/identity_/api/group/{partitionGlobalId}​/{groupId}

Eine URL für eine mandantenspezifische Ressource kann folgendermaßen aussehen: https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/Assets.