API Postman : fonctions disponibles et usage avec des agents IA
Postman est l'outil le plus répandu pour tester et documenter des API, et il dispose aussi de sa propre API pour gérer collections, environnements, workspaces, mocks et moniteurs. Les équipes de développement et de QA qui veulent automatiser la maintenance de ces ressources l'utilisent. L'accès se fait avec une clé d'API générée dans le compte.
Ce que propose l’API Postman
Collections
Lecture, création et mise à jour de collections de requêtes.
Environnements
Gestion des variables d'environnement, comme les URL de recette et de production.
Workspaces
Organisation des collections et des environnements par équipe ou par projet.
Mocks
Serveurs simulés pour tester des intégrations avant que l'API réelle soit prête.
Moniteurs
Exécutions planifiées de collections pour suivre la santé des API.
Spécifications d'API
Gestion de définitions comme OpenAPI dans Postman.
Comment accéder à l’API Postman
- Avec les identifiants de votre entrepriseClé d'API générée dans les paramètres du compte Postman, envoyée dans l'en-tête de chaque requête.
- Les variables d'environnement peuvent contenir des secrets : restreignez l'accès de l'agent.
- Des limites d'usage de l'API s'appliquent selon l'offre Postman.
- Évitez les permissions de suppression de collections et de workspaces.
Documentation officielle: learning.postman.com/docs/developer/postman-api/intro-api
Ce qu’un agent iTeam fait avec l’API Postman
La collection comme documentation pour l'agent
L'agent s'appuie sur la collection de l'équipe comme référence des endpoints internes et n'appelle que ce qui y est décrit.
Suivi des moniteurs
L'agent lit les résultats des moniteurs et ouvre un ticket avec la requête en échec et la réponse reçue.
Mise à jour des environnements
Quand l'URL de recette change, l'agent met à jour la variable dans les bons environnements et prévient l'équipe.
Revue des collections obsolètes
L'agent compare la collection à la spécification OpenAPI et signale les endpoints sans exemple ou supprimés.
De l’identifiant à l’agent au travail, avec validation
Générer la clé d'API
Dans le compte Postman, créez une clé d'API pour un compte technique ayant accès aux seuls workspaces nécessaires.
Stocker dans le coffre-fort d'iTeam
Enregistrez la clé et définissez si l'agent lit seulement les collections et les moniteurs, ou s'il peut aussi modifier les environnements.
Commencer en lecture
Lancez d'abord en mode lecture et autorisez les modifications quand l'équipe a validé les rapports de l'agent.
Équipes IA prêtes à l’emploi pour ce travail
Analyse de données
Posez une question métier dans Slack ou Teams : l'équipe écrit la requête, vérifie le résultat et vous répond avec le chiffre et sa source.
Support informatique interne
Mot de passe, accès, matériel : la demande est posée dans Slack ou Teams, l'agent répond ou ouvre un ticket Jira complet.
Questions sur l’API Postman
L'API Postman est-elle gratuite ?
L'API est disponible aussi dans les offres gratuites, avec des limites d'usage. Les offres payantes élargissent ces limites et les fonctions d'équipe.
Faut-il programmer pour utiliser l'API Postman avec iTeam ?
Pas nécessairement. L'équipe de déploiement configure l'accès, et l'agent peut même s'appuyer sur vos collections existantes pour apprendre vos API.
iTeam peut-il importer une collection Postman comme outil ?
Une collection bien documentée constitue une excellente base pour que l'outil HTTP d'iTeam apprenne les endpoints d'un système interne.
