API HTTP v1
Utilisez les 23 opérations d'Autonomy depuis des scripts, des tâches CI et d'autres clients HTTP.
L'API HTTP v1 permet aux scripts, aux tâches CI et aux services de travailler directement avec Autonomy. Elle couvre les projets, les cas de test, les plans de test, les exécutions (avec leurs Step Actions et leurs preuves), les environnements et les problèmes.
L'URL de base est https://api.autonomyqa.com. Chaque opération utilise la même forme de route et un corps objet JSON :
POST https://api.autonomyqa.com/api/v1/<resource>.<verb>
Authorization: Bearer <credential>
Content-Type: application/jsonPar exemple, test_case.create correspond à POST /api/v1/test_case.create et run.get à POST /api/v1/run.get. Il n'y a pas de chaîne de requête : chaque argument va dans le corps, même pour les lectures. Une réponse réussie est le résultat de l'opération en JSON, sans enveloppe.
Le document OpenAPI 3.1, lisible par machine, se trouve à GET /api/openapi.json. L'operationId de chaque opération est son nom avec le point remplacé par un underscore, comme test_case_create, et x-scope indique la portée dont elle a besoin.
Les opérations en un coup d'œil
| Ressource | Opérations |
|---|---|
| Projets | project.list, project.get |
| Cas de test | test_case.list, test_case.get, test_case.create, test_case.update_steps, test_case.archive |
| Plans de test | test_plan.list, test_plan.get, test_plan.create, test_plan.set_members |
| Exécutions | run.trigger, run.list, run.get, run.step_actions, run.evidence |
| Environnements | environment.list, environment.get, environment.upsert |
| Problèmes | issue.list, issue.create, issue.comment, issue.set_status |
Créer un cas de test, un plan de test ou un environnement nécessite un projectId, et les opérations de liste peuvent filtrer sur ce champ. Appelez d'abord project.list pour le trouver.
API HTTP et MCP
HTTP et MCP partagent les mêmes 23 opérations, avec les mêmes arguments, résultats, portées, règles de confirmation et erreurs. Sur MCP, chaque opération est un outil nommé autonomy_ suivi du nom de l'opération, les points étant remplacés par des underscores, comme autonomy_run_get.
Utilisez MCP lorsqu'un assistant IA doit travailler avec Autonomy depuis un éditeur. Utilisez cette API HTTP pour les scripts, les pipelines CI et les systèmes qui envoient des requêtes JSON. Les deux diffèrent par la façon de se connecter : l'API HTTP accepte les clés d'API d'organisation et les jetons OAuth, tandis que MCP utilise uniquement OAuth.
Pour commencer
- Authentifiez chaque requête.
- Choisissez une opération dans le catalogue d'opérations.
- Suivez les exécutions et lisez leurs preuves avec le parcours des exécutions et des preuves.
- Gérez les erreurs.
Vous n’avez pas trouvé ?