Développeurs (MCP et API)
Créer des jetons d'accès pour relier un assistant IA (MCP) ou vos scripts (API) à l'organisation, choisir leurs autorisations et les révoquer.
Les jetons d'accès relient un assistant IA (par le serveur MCP) ou vos propres scripts (par l'API) à l'organisation, sans mot de passe ni cookie. Ouvrez Réglages › Développeurs.
Ils demandent l'offre Pro avec l'option CRM. Seuls les propriétaires et les administrateurs les gèrent.
Créer un jeton
- Cliquez sur Créer un jeton.
- Donnez-lui un nom qui dit où il sert, par exemple « Claude Desktop ».
- Cochez ses autorisations, en Lecture et en Écriture.
- Choisissez quand il expire : dans 30 jours, 90 jours, un an, ou jamais.
- Copiez le jeton : il commence par
vt_pat_et ne sera plus affiché. Gardez-le dans un gestionnaire de mots de passe.
Vintarget n'en garde qu'une empreinte : personne, pas même nous, ne peut vous le réafficher. Si vous l'avez perdu, révoquez-le et créez-en un autre.
Ce qu'un jeton peut faire
Un jeton agit en votre nom, dans ses autorisations, et jamais au-delà de ce que votre rôle permet. Si votre rôle change, il perd ce que vous perdez. Si vous quittez l'organisation, il cesse de fonctionner.
| Autorisation | Permet |
|---|---|
stock:read | lire le stock |
stock:write | modifier le stock |
purchases:read | lire les achats, y compris ceux du bot |
purchases:write | enregistrer et modifier les achats |
listings:read | lire les annonces |
listings:write | publier et modifier des annonces |
sales:read | lire les ventes |
sales:write | enregistrer et modifier les ventes |
analytics:read | lire les statistiques |
imports:write | importer des fichiers |
Un jeton ne peut jamais acheter, payer, envoyer une offre Vinted, modifier les filtres ou Auto Cop, ni gérer les membres, la facturation, les comptes Vinted ou l'organisation.
Donnez une autorisation d'écriture seulement à un client de confiance : il modifiera les données de l'organisation en votre nom. Chaque modification faite par un jeton est inscrite au journal (Réglages › Membres), avec le jeton et le client.
Révoquer un jeton
Cliquez sur Révoquer à côté du jeton, puis confirmez. Il cesse de fonctionner immédiatement. Si un administrateur révoque votre jeton, vous en êtes notifié.
La liste montre aussi la dernière utilisation de chaque jeton : révoquez ceux qui ne servent plus.
Pour les développeurs
Envoyez le jeton dans l'en-tête Authorization :
curl https://api.vintarget.fr/v1/me \
-H "Authorization: Bearer vt_pat_…"GET /v1/me renvoie l'organisation, le jeton et ses autorisations : de quoi vérifier votre configuration. Les routes du stock et le serveur MCP arrivent ensuite.
- Limites : 60 requêtes par minute et par jeton, et un quota par jour pour l'organisation (10 000 avec Pro et l'option CRM). Au-delà, la réponse est
429avec l'en-têteRetry-After(en secondes). - Erreurs :
401 invalid_tokenpour un jeton absent, inconnu, révoqué ou expiré ;403 insufficient_scopequand il manque une autorisation ;403 plan_requiredsi l'offre n'inclut plus l'accès API. - Les corps de requête sont en JSON. L'API ne s'appelle pas depuis un navigateur : gardez le jeton côté serveur ou dans votre client MCP.