API HTTP v1

L’API HTTP v1 expose le plan de contrôle QA d’Autonomy aux scripts, aux tâches CI et aux services. Elle couvre les cas de test, les plans de test, les exécutions, les environnements, les preuves externes et les notes.

Définissez l’URL de base sur l’URL de site Convex, c’est-à-dire la valeur de NEXT_PUBLIC_CONVEX_SITE_URL, par exemple https://your-deployment.convex.site. N’utilisez pas l’URL .convex.cloud.

Chaque opération du catalogue utilise la même forme de route et un corps objet JSON :

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

Par exemple, test_case.create correspond à POST /api/v1/test_case.create et run.get à POST /api/v1/run.get. Les réponses sont en JSON.

Le document OpenAPI 3.1 lisible par machine est servi par chaque déploiement à GET /api/openapi.json. Pour un déploiement dédié, utilisez plutôt GET <NEXT_PUBLIC_CONVEX_SITE_URL>/api/openapi.json.

API HTTP et MCP

HTTP et MCP sont générés depuis le même catalogue d’opérations et partagent donc les mêmes arguments, valeurs de retour, portées, règles de confirmation et erreurs. MCP expose 15 opérations. Les trois opérations de Notes sont réservées à HTTP ; l’API HTTP contient donc les 18 opérations.

Utilisez MCP lorsqu’un assistant IA doit piloter Autonomy via son protocole d’outils. Utilisez cette API HTTP pour les scripts, pipelines CI ou systèmes qui nécessitent des requêtes JSON directes.

Pour commencer

1. Authentifiez chaque requête.
2. Choisissez une route dans le catalogue d’opérations.
3. Pour les exécutions asynchrones, suivez le flux des exécutions et des preuves externes.
4. Gérez l’ensemble fermé d’erreurs structurées.