Guida API e MCP ai link di condivisione di Drive
Crea, elenca e revoca link pubblici di TrekMail Drive tramite API REST o MCP, con scadenze, limiti di download e registri di audit.
Dettagli dell'articolo
Tipo, difficoltà, piani e data dell'ultimo aggiornamento.
▼
Dettagli dell'articolo
Tipo, difficoltà, piani e data dell'ultimo aggiornamento.
- Tipo
- Riferimento
- Difficoltà
- Intermedio
- Piani
- Starter · Pro · Agency · + Drive Add-on
- Ultimo aggiornamento
- 10 set 2026
I link di condivisione consentono di consegnare un file di Drive all’esterno del tuo account TrekMail senza inviare un allegato e-mail di grandi dimensioni. L’API e gli strumenti MCP possono creare link, elencare i link di un file e revocarli quando l’accesso deve terminare.
Usa i link di condivisione per materiali destinati ai clienti, fatture, file video, pacchetti di esportazione e qualsiasi file troppo grande o temporaneo per essere allegato a un’e-mail.
Ambiti richiesti
Per i file del Drive dell’account, usa drive:account:share. Per i file del Drive della casella di posta, usa drive:mailbox:share. Anche un ambito di lettura è utile, perché nella maggior parte dei flussi di lavoro occorre trovare il file prima di condividerlo.
Gli ambiti di condivisione non consentono di caricare, rinominare, spostare, cestinare, ripristinare o eliminare definitivamente i file. Mantienili separati quando l’unico compito dell’agente è la consegna.
Creare un link con 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 risposta include l’URL pubblico. Il token di condivisione non elaborato viene restituito solo al momento della creazione. Se lo perdi, revoca il link e creane uno nuovo.
Creare un link con MCP
drive_share_create(file_id=123, expires_at="2026-06-01T00:00:00Z", max_downloads=25)
Chiedi all’agente di restituire l’URL nella risposta finale e di indicare la scadenza e il limite di download.
Elencare e revocare i link
Usa l’endpoint di elenco o drive_share_list per vedere i link attivi e passati di un file. Revoca un link quando è stato inviato alla persona sbagliata, un contratto non è più valido o un periodo di consegna temporaneo è terminato.
drive_share_revoke(link_id=456)
La revoca è immediata. Crea un nuovo link se occorre ripristinare l’accesso.
Valori predefiniti consigliati
| Caso d’uso | Scadenza | Limite di download |
|---|---|---|
| File da sottoporre al cliente | 7-14 giorni | 10-50 |
| Contratto firmato | 30-90 giorni | 5-20 |
| Risorsa per campagna pubblica | Data di fine della campagna | Limite più alto se necessario |
| Consegna interna temporanea | 1-7 giorni | 5-10 |
I link senza limiti sono pratici, ma in seguito è più difficile valutarli. Se scegli di non impostare una scadenza, aggiungi una nota nel tuo sistema che ne spieghi il motivo.
Comportamento di sicurezza
Un link di condivisione è pubblico per chiunque disponga dell’URL. È protetto da un token impossibile da indovinare, non da un accesso a TrekMail. Non inviare link pubblici per file che richiedono l’accesso di destinatari specifici, a meno che la tua organizzazione non accetti questo modello.
La pagina di download non rivela dettagli superflui dell’account. I link scaduti, revocati o che hanno raggiunto il limite non funzionano senza esporre informazioni private sul file.
Registro di audit
La creazione e la revoca dei link di condivisione vengono registrate con l’identità del token API. Se un agente crea link per i clienti, controlla periodicamente il registro di audit e sostituisci i token quando cambiano le responsabilità del team.
Articoli correlati
Vai alle guide vicine che proseguono il flusso di lavoro.