API-Version

Der Test Manager bietet zwei API-Versionen, über die Sie integrieren können. Die erste Version der APIs ist nicht durch eine rollenbasierte Zugriffskontrolle geschützt. Die zweite Version der APIs ist mit rollenbasierter Zugriffskontrolle im Scope eines bestimmten Projekts geschützt. Mehrere veraltete APIs sind nur für Organisationsadministratoren zugänglich. Auf die zweite Version dieser APIs können jetzt auch die Projektbesitzer zugreifen, auch wenn sie keine Organisationsadministratoren sind.

Versionszeitplan

V1 wurde im April 2023 (Release 2023.4) veraltet und entfernt, sowohl für die eigenständige als auch für die Automation Suite-Version des Test Managers.

Versionsbasierte APIs

API-Version	Berechtigungen	Beschreibung
V1	• Anhänge • AzureDevOpsConnector (veraltet) • Fähigkeiten • Konfiguration • Connectors (veraltet) • CustomFieldDefinitions (veraltet) • CustomFieldValues • Defekte • JiraCloudBasicAuthConnector (veraltet) • JiraCloudOAuthConnector (veraltet) • JiraConnectorWebHooks • JireServerConnector (veraltet) • KPIs • ObjectLabels • Orchestrator • ProjectReports • Projekte (veraltet) • RedmineConnector (veraltet) • Anforderungen (veraltet) • ServerInfo • ServiceNowConnector (veraltet) • Einstellungen • Telemetrie • TestCaseLogs • TestCases • TestExecutions • TestSets • TestSteps • ThirdPartyAuth (veraltet) • UserAuth • Benutzer • UserSession • Benutzereinstellungen • WebHookConfiguration (veraltet) • XrayCloudConnector (veraltet) • XrayConnectorWebhooks • XrayServerConnector (veraltet)	Verfügbar für Organisationsadministratoren und Nicht-Administratorbenutzer. Nicht durch die rollenbasierte Zugriffskontrolle geschützt.
V2	• AzureDevOpsConnector • Konnektoren • CustomFieldDefinitions • JiraCloudBasicAuthConnector • JiraCloudOAuthConnector • JiraServerConnector • ProjectPermissions • Projekte • QtestConnector • RedmineConnector • Anforderungen • ServiceNowConnector • WebHook-Konfiguration • XrayCloudConnector • XrayServerConnector	Verfügbar für Administratoren und Projektbesitzer.

API-Version aktualisieren

Aktualisieren Sie die API-Version mit Swagger, um rollenbasierte Zugriffsaufrufe zu erstellen.

Fügen Sie /swagger/index.html zu Ihrer Test Manager-Instanz-URL hinzu (z. B. https://testmanager.com/swagger/index.html).
Klicken Sie oben auf der Seite auf Definition auswählen und wählen Sie V2 aus der Dropdownliste aus.
Die Anfragen beinhalten nun die Versionsnummer, wie im folgenden Beispiel zu erkennen.
```
curl -X 'GET' \
  'https://company/testmanager/companyTenant/testmanager_/api/v2/projects' \
  -H 'accept: application/json'curl -X 'GET' \
  'https://company/testmanager/companyTenant/testmanager_/api/v2/projects' \
  -H 'accept: application/json'
```