Champs d’application et autorisations de l’API Drive

Les champs d’application Drive déterminent précisément ce qu’un jeton d’API ou un agent MCP peut faire avec TrekMail Drive. Un bon jeton est restreint : il possède le plus petit ensemble de champs nécessaire à une tâche, un nom clair et une date d’expiration.

L’API Drive comporte 11 champs d’application couvrant le Drive du compte, celui des boîtes aux lettres, les liens de partage, la suppression définitive, l’état du module Drive et les mots de passe des appareils de synchronisation. Ces champs appartiennent aux jetons d’exploitation (tm_live_...). Les jetons de message (tm_msg_...) restent destinés aux opérations de messagerie.

Référence des champs d’application

Lecture, écriture, partage et purge

Drive sépare les tâches courantes en quatre niveaux d’autorisation :

• La lecture permet de répertorier les espaces, parcourir les dossiers, examiner les métadonnées, voir la corbeille et demander des URL de téléchargement.
• L’écriture permet de téléverser, créer des dossiers, renommer, déplacer, mettre à la corbeille et restaurer.
• Le partage permet de créer, répertorier et révoquer des liens de partage publics.
• La purge permet de supprimer définitivement des éléments de la corbeille ou de vider celle-ci.

N’accordez pas la purge à un assistant polyvalent. Si vous avez besoin d’un nettoyage automatisé, créez un jeton séparé nommé d’après cette tâche, laissez-le désactivé dans MCP jusqu’à son utilisation et vérifiez le journal d’audit après chaque exécution.

Accès selon l’offre et le module

L’accès à l’API Drive est disponible lorsque le compte bénéficie de Drive grâce à une offre payante ou à un module de stockage Drive actif. Un compte gratuit doté d’un module actif peut utiliser les champs Drive pour automatiser le stockage, tout comme les champs du Vérificateur d’e-mails sont accessibles indépendamment de l’accès complet à l’API d’infrastructure.

Si un module Drive est résilié et entre dans sa période de grâce, l’accès en lecture peut rester disponible afin d’examiner et d’exporter les fichiers. Les accès en écriture, partage et purge peuvent être restreints jusqu’au retour du compte à un état de stockage actif.

Drive du compte et Drive des boîtes aux lettres

Les champs du Drive du compte et ceux des boîtes sont volontairement distincts. Un agent de facturation ou d’exploitation peut n’avoir besoin que du Drive du compte. Un assistant de boîte peut n’avoir besoin que du Drive d’une seule boîte.

Utilisez les limites de boîte lors de la création d’un jeton d’automatisation. Un jeton restreint ne voit que les espaces des boîtes autorisées. Les demandes visant d’autres boîtes renvoient une réponse de type « introuvable », ce qui évite de révéler la structure du compte à une intégration à portée limitée.

Le champ du module Drive est en lecture seule

drive:addon:read permet à un agent de lire l’état, les tarifs et l’aperçu de résiliation du module. Il ne permet pas d’acheter du stockage, de modifier la capacité d’un module, de résilier un abonnement ni de déclencher une opération de paiement.

Cette limite est volontaire. Les changements de facturation du stockage restent dans le tableau de bord, où une personne peut vérifier la capacité, le prix, la devise, la période de facturation et la confirmation du paiement. Il n’existe aucun champ drive:addon:write.

Mots de passe des appareils de synchronisation

drive:devices:read et drive:devices:write gèrent les mots de passe distincts utilisés par les applications de synchronisation WebDAV. Ils ne correspondent pas au jeton d’API. Un mot de passe d’appareil créé n’est affiché qu’une fois; enregistrez-le immédiatement dans l’application de synchronisation ou un gestionnaire de mots de passe. Dans la mesure du possible, séparez la gestion des appareils d’un jeton général d’automatisation des fichiers et révoquez le mot de passe d’un appareil lorsque son ordinateur ou son application ne doit plus se connecter.

Les réponses de liste, de création et de renouvellement des appareils contiennent server_url. Utilisez l’adresse renvoyée au lieu de construire vous-même /dav : les comptes disposant d’une zone de messagerie White Label entièrement configurée reçoivent leur nom d’hôte DAV personnalisé, tandis que tous les autres reçoivent le nom d’hôte opérationnel de la plateforme.

Modèles de jetons recommandés

Conséquence de l’absence d’un champ

Si un jeton ne possède pas le champ Drive requis, l’API renvoie une erreur d’autorisation. Si les restrictions du jeton excluent une boîte ou une ressource, l’API peut renvoyer « introuvable ». Cela protège la structure privée du compte contre les intégrations qui ne doivent pas la connaître.

Articles connexes

• Créer et gérer des jetons d’API
• Présentation de l’API Drive
• Limites de l’API du module de stockage Drive