Version de l’API

Test Manager provides two API versions through which you can integrate. The first version of the APIs is not protected with role-based access control. The second version of the APIs is protected with role-based access control in a given project's scope. Several legacy APIs are only accessible by Organization Administrators. The second version of these APIs can now be accessed by Project Owners too, even if they are not Organization Administrators.

Calendrier de version

La V1 a été obsolète et supprimée le 7 mars 2023.

API basées sur la version

Version de l'API	Autorisations	Description
V1	• Pièces jointes (Attachments) • AzureDevOpsConnector (obsolète) • Capabilities • Configuration • Connecteurs (obsolète) • CustomFieldDefinitions (obsolète) • ValeursChampPersonnalisé (CustomFieldValues) • Défauts • JiraCloudBasicAuthConnector (obsolète) • JiraCloudOAuthConnector (obsolète) • JiraConnectorWebHooks • JireServerConnector (obsolète) • ICP • ÉtiquetteObjets (ObjectLabels) • Orchestrator • RapportsProjet (ProjectReports) • Projets (obsolète) • RedmineConnector (obsolète) • Exigences (obsolète) • InfosServeur (ServerInfo) • ServiceNowConnector (obsolète) • Paramètres • Télémétrie • JournauxCasTest (TestCaseLogs) • Cas de test • Exécutions de test • Ensembles de tests • ÉtapesTest (TestSteps) • ThirdPartyAuth (obsolète) • Authentification utilisateur • Utilisateurs • SessionUtilisateur • Paramètres utilisateur • WebHookConfiguration (obsolète) • XrayCloudConnector (obsolète) • XrayConnectorWebhooks • XrayServerConnector (obsolète)	Disponible pour les administrateurs d'organisation et les utilisateurs non administrateurs. Non protégé par le contrôle d'accès basé sur les rôles.
V2	• AzureDevOpsConnector • Connecteurs • DéfinitionsChampPersonnalisé • JiraCloudBasicAuthConnector • JiraCloudOAuthConnector • ConnecteurServeurJira • AutorisationsProjet • Projets • QtestConnector • ConnecteurRedmine • Prérequis • ServiceNowConnector • WebHookConfiguration • XrayCloudConnector • ConnecteurXrayServer	Disponible pour les administrateurs et les propriétaires de projet.

Mettre à jour la version de l'API

Mettez à jour la version de l'API à l'aide de Swagger pour effectuer des appels d'accès basés sur les rôles.

Add /swagger/index.html to your Test Manager instance URL (e.g., https://testmanager.com/swagger/index.html).
Cliquez sur Sélectionner une définition (Select a definition) en haut de la page et sélectionnez V2 dans la liste déroulante.
Désormais, les demandes incluent le numéro de version, comme vous pouvez le voir dans l'exemple suivant.
```
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'
```