Handleiding voor de Drive-API en MCP voor deellinks

Met deellinks kun je een Drive-bestand buiten je TrekMail-account afleveren zonder een grote e-mailbijlage te verzenden. De API en MCP-hulpmiddelen kunnen links maken, links voor een bestand weergeven en links intrekken wanneer de toegang moet eindigen.

Gebruik deellinks voor klantbestanden, facturen, videobestanden, exportpakketten en elk bestand dat te groot of te tijdelijk is voor een e-mailbijlage.

Vereiste scopes

Gebruik drive:account:share voor bestanden in de Drive van het account. Gebruik drive:mailbox:share voor bestanden in de Drive van het postvak. Een leesscope is ook nuttig, omdat in de meeste werkstromen het bestand vóór het delen moet worden gevonden.

Deelscopes staan uploaden, hernoemen, verplaatsen, naar de prullenbak verplaatsen, herstellen of definitief verwijderen niet toe. Houd ze afzonderlijk wanneer de agent alleen voor aflevering wordt ingezet.

Een link maken met 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}'

Het antwoord bevat de openbare URL. Het onbewerkte deeltoken wordt alleen bij het maken teruggegeven. Als je het kwijtraakt, trek je de link in en maak je een nieuwe.

Een link maken met MCP

drive_share_create(file_id=123, expires_at="2026-06-01T00:00:00Z", max_downloads=25)

Vraag de agent om de URL in het uiteindelijke antwoord te geven en de vervaldatum en downloadlimiet te vermelden.

Links weergeven en intrekken

Gebruik het lijst-endpoint of drive_share_list om actieve en historische links voor een bestand te bekijken. Trek een link in wanneer deze naar de verkeerde persoon is gestuurd, een contract niet meer geldig is of een tijdelijk aflevervenster is gesloten.

drive_share_revoke(link_id=456)

Intrekking gaat onmiddellijk in. Maak een nieuwe link als de toegang moet worden hersteld.

Aanbevolen standaardwaarden

Onbeperkte links zijn handig, maar later moeilijker te beoordelen. Als je geen vervaldatum kiest, voeg dan in je eigen systeem een notitie toe waarin je uitlegt waarom.

Beveiligingsgedrag

Een deellink is openbaar voor iedereen die de URL heeft. Deze wordt beschermd door een niet te raden token, niet door een TrekMail-aanmelding. Stuur geen openbare links voor bestanden waarvoor toegang door specifiek benoemde ontvangers vereist is, tenzij je organisatie dit model accepteert.

De downloadpagina maakt geen onnodige accountgegevens bekend. Verlopen, ingetrokken of opgebruikte links werken niet zonder persoonlijke bestandsinformatie prijs te geven.

Auditspoor

Het maken en intrekken van deellinks wordt geregistreerd met de identiteit van het API-token. Als een agent links voor klanten maakt, controleer je het auditlogboek regelmatig en vervang je tokens wanneer teamverantwoordelijkheden veranderen.