API- und MCP-Leitfaden für Drive-Freigabelinks

Mit Freigabelinks können Sie eine Drive-Datei außerhalb Ihres TrekMail-Kontos bereitstellen, ohne einen großen E-Mail-Anhang zu versenden. Die API und MCP-Werkzeuge können Links erstellen, die Links einer Datei auflisten und Links widerrufen, wenn der Zugriff enden soll.

Verwenden Sie Freigabelinks für Kundendateien, Rechnungen, Videodateien, Exportpakete und alle Dateien, die für einen E-Mail-Anhang zu groß oder zu kurzlebig sind.

Erforderliche Berechtigungsumfänge

Verwenden Sie für Dateien im Konto-Drive drive:account:share. Verwenden Sie für Dateien im Postfach-Drive drive:mailbox:share. Ein Leseumfang ist ebenfalls hilfreich, weil die Datei in den meisten Abläufen vor der Freigabe gefunden werden muss.

Freigabeumfänge erlauben kein Hochladen, Umbenennen, Verschieben, Verschieben in den Papierkorb, Wiederherstellen oder endgültiges Löschen. Halten Sie diese Berechtigungen getrennt, wenn die einzige Aufgabe des Agenten die Zustellung ist.

Link mit REST erstellen

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}'

Die Antwort enthält die öffentliche URL. Das unverarbeitete Freigabetoken wird nur beim Erstellen zurückgegeben. Wenn Sie es verlieren, widerrufen Sie den Link und erstellen Sie einen neuen.

Link mit MCP erstellen

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

Bitten Sie den Agenten, die URL in seiner abschließenden Antwort auszugeben und das Ablaufdatum sowie das Downloadlimit zu nennen.

Links auflisten und widerrufen

Verwenden Sie den Listen-Endpoint oder drive_share_list, um aktive und frühere Links für eine Datei anzuzeigen. Widerrufen Sie einen Link, wenn er an die falsche Person gesendet wurde, ein Vertrag nicht mehr gültig ist oder ein vorübergehendes Zustellungsfenster geschlossen wurde.

drive_share_revoke(link_id=456)

Der Widerruf gilt sofort. Erstellen Sie einen neuen Link, wenn der Zugriff wiederhergestellt werden soll.

Empfohlene Standardwerte

Unbegrenzte Links sind praktisch, lassen sich später aber schwerer einschätzen. Wenn Sie kein Ablaufdatum wählen, fügen Sie Ihrem eigenen System eine Notiz hinzu, die den Grund erläutert.

Sicherheitsverhalten

Ein Freigabelink ist für jeden öffentlich, der die URL besitzt. Er wird durch ein nicht zu erratendes Token und nicht durch eine TrekMail-Anmeldung geschützt. Senden Sie keine öffentlichen Links für Dateien, die Zugriff für namentlich benannte Empfänger erfordern, sofern Ihre Organisation dieses Modell nicht akzeptiert.

Die Downloadseite legt keine unnötigen Kontodaten offen. Abgelaufene, widerrufene oder ausgeschöpfte Links schlagen fehl, ohne private Dateiinformationen preiszugeben.

Auditprotokoll

Das Erstellen und Widerrufen von Freigabelinks wird mit der Identität des API-Tokens protokolliert. Wenn ein Agent Links für Kunden erstellt, prüfen Sie regelmäßig das Auditprotokoll und wechseln Sie Tokens aus, wenn sich die Zuständigkeiten im Team ändern.