API HTTP v1

La API HTTP v1 expone el plano de control de QA de Autonomy a scripts, trabajos de CI y servicios. Incluye casos de prueba, planes de prueba, ejecuciones, entornos, evidencia externa y notas.

Configura como URL base la URL del sitio de Convex: el valor de NEXT_PUBLIC_CONVEX_SITE_URL, por ejemplo, https://your-deployment.convex.site. No uses la URL .convex.cloud.

Todas las operaciones del catálogo usan la misma forma de ruta y un cuerpo que es un objeto JSON:

POST <NEXT_PUBLIC_CONVEX_SITE_URL>/api/v1/<resource>.<verb>
Content-Type: application/json

Por ejemplo, test_case.create es POST /api/v1/test_case.create y run.get es POST /api/v1/run.get. Las respuestas son JSON.

Cada despliegue sirve el documento OpenAPI 3.1 legible por máquinas en GET /api/openapi.json. En un despliegue dedicado, usa GET <NEXT_PUBLIC_CONVEX_SITE_URL>/api/openapi.json.

API HTTP y MCP

HTTP y MCP se generan a partir del mismo catálogo de operaciones, por lo que usan los mismos argumentos, valores de retorno, permisos, reglas de confirmación y errores. MCP expone 15 operaciones. Las tres operaciones de Notes son exclusivas de HTTP, así que la API HTTP contiene las 18 operaciones.

Usa MCP cuando un asistente de IA deba operar Autonomy mediante su protocolo de herramientas. Usa esta API HTTP para scripts, procesos de CI o sistemas que necesiten solicitudes JSON directas.

Primeros pasos

1. Autentica cada solicitud.
2. Elige una ruta del catálogo de operaciones.
3. Para ejecuciones asíncronas, sigue el flujo de ejecuciones y evidencia externa.
4. Gestiona el conjunto cerrado de errores estructurados.