Guide de l’API et de MCP pour les liens de partage Drive
Créez, listez et révoquez des liens publics TrekMail Drive via l’API REST ou MCP, avec expiration, limites de téléchargement et journal d’audit.
Détails de l’article
Type, difficulté, forfaits et date de dernière mise à jour.
▼
Détails de l’article
Type, difficulté, forfaits et date de dernière mise à jour.
- Type
- Référence
- Difficulté
- Intermédiaire
- Forfaits
- Starter · Pro · Agency · + Drive Add-on
- Dernière mise à jour
- 10 sept. 2026
Les liens de partage vous permettent de transmettre un fichier Drive en dehors de votre compte TrekMail sans envoyer une pièce jointe volumineuse par e-mail. L’API et les outils MCP peuvent créer des liens, répertorier les liens d’un fichier et les révoquer lorsque l’accès doit prendre fin.
Utilisez les liens de partage pour les livrables destinés aux clients, les factures, les fichiers vidéo, les lots d’exportation et tout fichier trop volumineux ou trop temporaire pour être joint à un e-mail.
Champs d’application requis
Pour les fichiers du Drive du compte, utilisez drive:account:share. Pour les fichiers du Drive d’une boîte aux lettres, utilisez drive:mailbox:share. Un champ d’application de lecture est également utile, car la plupart des processus doivent trouver le fichier avant de le partager.
Les champs d’application de partage ne permettent pas de téléverser, renommer, déplacer, mettre à la corbeille, restaurer ou purger des fichiers. Gardez-les séparés lorsque la seule tâche de l’agent est la livraison.
Créer un lien avec REST
curl -s -X POST "https://trekmail.net/api/v1/drive/files/{FILE_ID}/share-links" \
-H "Authorization: Bearer tm_live_your_token" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: share-{FILE_ID}-client-a" \
-d '{"expires_at":"2026-06-01T00:00:00Z","max_downloads":25}'
La réponse contient l’URL publique. Le jeton de partage brut est uniquement renvoyé lors de la création. Si vous le perdez, révoquez le lien et créez-en un nouveau.
Créer un lien avec MCP
drive_share_create(file_id=123, expires_at="2026-06-01T00:00:00Z", max_downloads=25)
Demandez à l’agent de renvoyer l’URL dans sa réponse finale et de préciser l’expiration et la limite de téléchargements.
Répertorier et révoquer des liens
Utilisez l’endpoint de liste ou drive_share_list pour consulter les liens actifs et historiques d’un fichier. Révoquez un lien s’il a été envoyé à la mauvaise personne, si un contrat n’est plus valable ou si une période de livraison temporaire est terminée.
drive_share_revoke(link_id=456)
La révocation est immédiate. Créez un nouveau lien si l’accès doit être rétabli.
Valeurs par défaut recommandées
| Cas d’utilisation | Expiration | Limite de téléchargements |
|---|---|---|
| Fichier à faire vérifier par un client | 7-14 jours | 10-50 |
| Contrat signé | 30-90 jours | 5-20 |
| Ressource d’une campagne publique | Date de fin de la campagne | Limite supérieure si nécessaire |
| Transmission interne temporaire | 1-7 jours | 5-10 |
Les liens sans limite sont pratiques, mais leur suivi ultérieur est plus difficile. Si vous choisissez de ne pas définir d’expiration, ajoutez dans votre propre système une note qui en explique la raison.
Comportement de sécurité
Un lien de partage est public pour toute personne qui possède l’URL. Il est protégé par un jeton impossible à deviner et non par une connexion TrekMail. N’envoyez pas de liens publics pour des fichiers qui exigent un accès réservé à des destinataires nommément désignés, sauf si votre organisation accepte ce modèle.
La page de téléchargement ne révèle pas de détails inutiles sur le compte. Les liens expirés, révoqués ou ayant atteint leur limite échouent sans exposer le contexte privé du fichier.
Journal d’audit
La création et la révocation des liens de partage sont consignées avec l’identité du jeton d’API. Si un agent crée des liens pour des clients, vérifiez régulièrement le journal d’audit et renouvelez les jetons lorsque les responsabilités de l’équipe changent.
Articles connexes
Articles similaires
Accédez aux guides voisins qui prolongent votre démarche.