API HTTP v1
Usa las 23 operaciones de Autonomy desde scripts, trabajos de CI y otros clientes HTTP.
La API HTTP v1 permite que scripts, trabajos de CI y servicios trabajen directamente con Autonomy. Abarca proyectos, casos de prueba, planes de pruebas, ejecuciones (con sus Step Actions y su evidencia), entornos e incidencias.
La URL base es https://api.autonomyqa.com. Todas las operaciones usan la misma forma de ruta y un cuerpo que es un objeto JSON:
POST https://api.autonomyqa.com/api/v1/<resource>.<verb>
Authorization: Bearer <credential>
Content-Type: application/jsonPor ejemplo, test_case.create es POST /api/v1/test_case.create y run.get es POST /api/v1/run.get. No hay cadena de consulta: todos los argumentos van en el cuerpo, incluso en las lecturas. Una respuesta correcta es el resultado de la operación en JSON, sin envoltorio.
El documento OpenAPI 3.1, legible por máquina, está en GET /api/openapi.json. El operationId de cada operación es su nombre con el punto sustituido por un guion bajo, como test_case_create, y x-scope indica el permiso que necesita.
Operaciones de un vistazo
| Recurso | Operaciones |
|---|---|
| Proyectos | project.list, project.get |
| Casos de prueba | test_case.list, test_case.get, test_case.create, test_case.update_steps, test_case.archive |
| Planes de pruebas | test_plan.list, test_plan.get, test_plan.create, test_plan.set_members |
| Ejecuciones | run.trigger, run.list, run.get, run.step_actions, run.evidence |
| Entornos | environment.list, environment.get, environment.upsert |
| Incidencias | issue.list, issue.create, issue.comment, issue.set_status |
Para crear un caso de prueba, un plan de pruebas o un entorno necesitas un projectId, y las operaciones de listado pueden filtrar por él. Llama primero a project.list para obtenerlo.
API HTTP y MCP
HTTP y MCP comparten las mismas 23 operaciones, con los mismos argumentos, resultados, permisos, reglas de confirmación y errores. En MCP, cada operación es una herramienta llamada autonomy_ más el nombre de la operación con los puntos sustituidos por guiones bajos, como autonomy_run_get.
Usa MCP cuando un asistente de IA deba trabajar con Autonomy desde un editor. Usa esta API HTTP para scripts, pipelines de CI y sistemas que envían solicitudes JSON. Se diferencian en cómo te autenticas: la API HTTP acepta claves de API de organización y tokens OAuth, mientras que MCP solo usa OAuth.
Primeros pasos
- Autentica cada solicitud.
- Elige una operación del catálogo de operaciones.
- Sigue las ejecuciones y lee su evidencia con el flujo de ejecuciones y evidencia.
- Gestiona los errores.
¿No lo encontraste?