TrekMail Drive-API im Überblick für Entwickler

Mit der TrekMail Drive-API können vertrauenswürdige Anwendungen und KI-Agenten denselben Dateispeicher verwenden, den Sie im Dashboard und Webmail sehen. Nutzen Sie sie, um Ordner aufzulisten, Dateien hochzuladen, öffentliche Downloadlinks zu erstellen, Papierkorbinhalte wiederherzustellen, die Speichernutzung zu prüfen und wiederkehrende Dateiabläufe zu automatisieren, ohne einem Agenten Zugriff auf Ihr gesamtes Konto zu geben.

Die Drive-Automatisierung ist Teil der TrekMail REST API v1. Sie verwendet Bearer-Tokens, JSON-Antworten, Idempotenzschutz, sofern der Endpunkt ihn unterstützt, und dasselbe Auditprotokoll, das unter KI-Agenten & API → Auditprotokoll angezeigt wird. Das Drive-Berechtigungsmodell umfasst 11 Bereiche, darunter separate Bereiche für Passwörter von Synchronisierungsgeräten. Die Kataloge der Endpunkte und MCP-Tools entwickeln sich weiter. Verwenden Sie deshalb die zurückgegebene Toolliste und die API-Antworten, um die aktuell für Ihr Token verfügbare Oberfläche zu ermitteln.

Was Sie automatisieren können

Typische Aufgaben der Drive-API sind:

• Monatliche Berichte in Account Drive hochladen.
• Einen Kundenordner erstellen, Dateien hinzufügen und einen Downloadlink freigeben.
• Einen Agenten Mailbox-Drive-Bereiche durchsuchen und Änderungen zusammenfassen lassen.
• Alte Dateien in einen Archivordner verschieben.
• Dateien nach einer versehentlichen Bereinigung aus dem Papierkorb wiederherstellen.
• Den Status des Drive-Add-ons lesen, bevor ein Benutzer vor fast vollem Speicher gewarnt wird.

Die API konzentriert sich bewusst auf Dateien. Sie ersetzt das Abrechnungs-Dashboard nicht und stellt keine Zahlungs- oder Abonnementänderungen bereit.

Account Drive und Mailbox Drive

Drive hat zwei Speicheroberflächen. Account Drive ist der gemeinsam genutzte Unternehmensbereich. Dort gehören normalerweise Markenmaterialien, Verträge, Onboarding-Unterlagen und Teamordner hin. Mailbox Drive ist persönlicher Speicher, der einem Postfach in Webmail zugeordnet ist.

API-Anfragen identifizieren das Ziel mit dem Parameter space:

account       # Account Drive
mailbox:42    # mailbox-personal Drive for mailbox ID 42
123           # internal Drive space ID, if your integration stores it

Tokens können auf bestimmte Postfächer beschränkt werden. Ist ein Token auf Postfach 42 begrenzt, geben Anfragen für Postfach 99 eine Antwort im Stil von "nicht gefunden" zurück, statt die Existenz des anderen Postfachs preiszugeben.

Authentifizierung und Basis-URL

Verwenden Sie ein Ops-Token im Authorization-Header:

Authorization: Bearer tm_live_your_token

Drive-Endpunkte befinden sich unter:

https://trekmail.net/api/v1/drive

Erstellen Sie Tokens unter KI-Agenten & API → Tokens. Wählen Sie nur die Drive-Berechtigungsbereiche aus, die Ihr Ablauf benötigt.

Die elf Drive-Berechtigungsbereiche

Uploads und große Dateien

Uploads verwenden ein zweistufiges Muster. Zuerst reserviert die API Kontingent und gibt Uploadanweisungen zurück. Ihr Client sendet dann die Dateibytes an die Upload-URL. Schließlich markiert die API den Upload als abgeschlossen. Große Dateien können mehrteilige Uploads verwenden und die URLs einzelner Teile aktualisieren, falls eine lange Übertragung abläuft.

Für die meisten KI-Agenten ist das MCP-Tool drive_file_upload einfacher als direkte Aufrufe von Low-Level-Upload-Endpunkten. Es verarbeitet die Ermittlung der Dateigröße, den Upload, den Abschluss und den Abbruch bei einem Fehler in einem einzigen Befehl.

Freigabelinks

Freigabelinks erstellen öffentliche Download-URLs für einzelne Dateien. Sie sind nützlich, wenn eine Datei für E-Mails zu groß ist oder der Zugriff widerrufen werden können soll. Legen Sie nach Möglichkeit ein Ablaufdatum und ein Downloadlimit fest. Das Roh-Token des Links wird nur einmal bei der Erstellung zurückgegeben. Speichern Sie die zurückgegebene URL daher sofort, wenn Ihr Ablauf sie benötigt.

Sicherheit beim Löschen

Normale Löschvorgänge verschieben Dateien und Ordner in den Papierkorb. Elemente bleiben wiederherstellbar, bis sie wiederhergestellt, endgültig gelöscht oder durch die Aufbewahrungsregeln des Produkts entfernt werden. Dauerhafte Löschvorgänge erfordern Löschbereiche und sollten in einem separaten Token isoliert werden.

Grenze des Drive-Add-ons

Agenten können Status, Preise und Kündigungsvorschau des Drive-Add-ons mit drive:addon:read lesen. Kauf, Größenänderung oder Kündigung des Drive-Add-ons sind nicht über REST- oder MCP-Schreibtools verfügbar. Diese Aktionen bleiben im Dashboard, damit die Speicherabrechnung bewusst und vom Benutzer kontrolliert erfolgt.