API Vercel : ce qu'elle permet et comment l'utiliser avec des agents IA
L'API REST de Vercel permet de créer et de suivre des déploiements, de gérer les projets, les domaines, les variables d'environnement et les équipes. Elle sert aux équipes front-end et plateforme qui publient des applications sur Vercel. L'accès se fait par un jeton d'accès créé dans le compte, avec une portée personnelle ou d'équipe.
Ce que propose l’API Vercel
Déploiements
Création, liste, statut, annulation et promotion des déploiements.
Projets
Configuration des projets, du framework et du lien avec le dépôt.
Domaines et DNS
Domaines du projet, vérification et enregistrements DNS.
Variables d'environnement
Lecture et modification par environnement : production, préproduction et développement.
Équipes et membres
Gestion des équipes et des accès.
Webhooks
Événements de déploiement créé, terminé ou en erreur.
Comment accéder à l’API Vercel
- API publiqueJeton d'accès créé dans les paramètres du compte, avec une portée sur l'équipe et une date d'expiration, transmis comme bearer token.
- Les variables d'environnement contiennent des secrets : l'agent ne doit pas les afficher.
- Respectez les limites de requêtes de l'API.
- Préférez des jetons avec expiration et portée d'équipe.
Documentation officielle: vercel.com/docs/rest-api
Ce qu’un agent iTeam fait avec l’API Vercel
Déploiement en erreur expliqué
Quand un déploiement échoue, l'agent lit le journal de build, pointe l'erreur et prévient le canal de l'équipe avec le lien du commit.
Prévisualisation pour le client
À l'ouverture de la pull request, l'agent envoie au responsable métier le lien de prévisualisation et ce qui a changé.
Domaine sur le point de poser problème
L'agent contrôle les domaines dont la configuration est en attente ou le DNS incorrect, et prévient l'IT.
Inventaire des variables
L'agent liste les projets auxquels il manque des variables obligatoires en production, sans exposer les valeurs.
De l’identifiant à l’agent au travail, avec validation
Créez un jeton à portée d'équipe
Définissez une expiration et choisissez la bonne équipe ; évitez les jetons personnels sans échéance.
Enregistrez-le dans le coffre iTeam
Le jeton reste dans le coffre, et chaque agent n'a que la lecture ou les actions autorisées.
Testez avec validation
Passer en production, modifier des variables ou des domaines nécessite une validation humaine.
É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 Vercel
L'API Vercel est-elle gratuite ?
En règle générale, oui : l'API est disponible dans les offres Vercel ; la consommation de ressources suit l'offre.
Faut-il programmer pour utiliser l'API Vercel avec iTeam ?
Pas nécessairement. Vercel figure dans le catalogue d'apps, et l'équipe de déploiement configure les flux.
Peut-on faire un rollback via l'API ?
L'API permet de promouvoir un déploiement antérieur ; dans iTeam, cette action est soumise à validation.
