Versión de la API

Test Manager proporciona dos versiones de API a través de las que se puede integrar. La primera versión de las API no está protegida con control de acceso basado en funciones. La segunda versión de las API está protegida con control de acceso basado en funciones en el ámbito de un proyecto determinado. Solo los administradores de organización pueden acceder a varias API heredadas. Los propietarios de proyectos también pueden acceder a la segunda versión de estas API aunque no sean administradores de organización.

Programa de versiones

V1 ha quedado obsoleto y se eliminó en abril de 2023 (versión 2023.4) tanto para la versión independiente como para la versión de Automation Suite de Test Manager.

API basadas en versiones

Versión de la API	Permisos	Descripción
V1	• Archivos adjuntos • AzureDevOpsConnector (obsoleto) • Capacidades • Configuración • Conectores (obsoleto) • CustomFieldDefinitions (obsoleto) • ValoresDeCampoPersonalizados • Defectos • JiraCloudBasicAuthConnector (obsoleto) • ConectorCloudOAuthDeJira (obsoleto) • JiraConnectorWebHook • JireServerConnector (obsoleto) • KPI • EtiquetasDeObjetos • Orchestrator • InformesDeProyectos • Proyectos (obsoleto) • RedmineConnector (obsoleto) • Requisitos (obsoleto) • InformaciónDelServidor ? ServiceNowConnector (obsoleto) • Configuración • Telemetría • RegistrosCasoDePrueba • CasosDePrueba • EjecucionesDePrueba • ConjuntosDePrueba • PasosDePrueba • SecondPartyAuth (obsoleto) ? UserAuth • Usuarios • SesiónUsuario • UserSettings • WebHookConfiguration (obsoleto) • XrayCloudConnector (obsoleto) • XrayConnectorWebhooks • ConectorServidorXray (obsoleto)	Disponible para administradores de organización y usuarios no administradores. No se protege a través del control de acceso basado en funciones.
V2	• AzureDevOpsConnector • Conectores • CustomFieldDefinitions • JiraCloudBasicAuthConnector • JiraCloudOAuthConnector ? JiraServerConnector • PermisosDelProyecto • Proyectos ? QtestConnector • RedmineConnector • Requisitos. • ServiceNowConnector • WebHookConfiguration • XrayCloudConnector • XrayServerConnector	Disponible para administradores y propietarios de proyectos.

Actualizar la versión de la API

Actualiza la versión de la API utilizando Swagger para realizar llamadas de acceso basadas en funciones.

Agrega /swagger/index.html a la URL de la instancia de Test Manager (por ejemplo, https://testmanager.com/swagger/index.html).
Haz clic en Seleccionar una definición en la parte superior de la página y selecciona V2 en la lista desplegable.
Ahora las solicitudes incluyen el número de versión que se puede ver en el siguiente ejemplo.
```
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'
```