Drive-API-Schnellstart für Entwickler

Dieser Schnellstart zeigt den sichersten Weg von „Ich möchte eine Integration“ zu einem funktionierenden Drive-API-Aufruf. Sie erstellen ein eng begrenztes Token, listen Drive-Bereiche auf, laden eine Datei hoch und erstellen einen öffentlichen Freigabelink mit Ablaufdatum.

1. Drive-Token erstellen

Öffnen Sie KI-Agenten & API → Tokens → Token erstellen. Geben Sie dem Token einen eindeutigen Namen wie drive-report-uploader. Wählen Sie nur die für Ihren Workflow erforderlichen Berechtigungen.

Verwenden Sie für diesen Leitfaden:

• drive:account:read
• drive:account:write
• drive:account:share

Nehmen Sie bei einer ersten Integration keine Purge-Berechtigungen auf. Verwenden Sie für dauerhaftes Löschen ein separates Wartungs-Token.

Kopieren Sie das Token direkt nach der Erstellung. TrekMail zeigt den Klartext nur einmal und speichert ausschließlich einen sicheren Hash.

2. Basis-URL und Token festlegen

export TREKMAIL_BASE_URL="https://trekmail.net"
export TREKMAIL_API_TOKEN="tm_live_your_token"

Jede Anfrage verwendet denselben Bearer-Header:

-H "Authorization: Bearer $TREKMAIL_API_TOKEN"

3. Verfügbare Drive-Bereiche auflisten

curl -s "$TREKMAIL_BASE_URL/api/v1/drive/spaces" \
  -H "Authorization: Bearer $TREKMAIL_API_TOKEN"

Die Antwort enthält Account Drive und alle Mailbox-Drive-Bereiche, die das Token sehen darf. Verwenden Sie in den nächsten Beispielen account für Account Drive.

4. Ordner erstellen

Schreiboperationen sollten einen Idempotenzschlüssel enthalten. Wenn Ihr Netzwerk die Anfrage wiederholt, kann TrekMail das ursprüngliche Ergebnis zurückgeben, statt Duplikate zu erstellen.

curl -s -X POST "$TREKMAIL_BASE_URL/api/v1/drive/spaces/account/folders" \
  -H "Authorization: Bearer $TREKMAIL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: folder-$(date +%s)" \
  -d '{"name":"API Uploads","color":"#2563eb"}'

Speichern Sie die zurückgegebene Ordner-ID.

5. Datei hochladen

Die REST-API trennt die Upload-Aushandlung von der Dateiübertragung. Starten Sie zuerst den Upload:

curl -s -X POST "$TREKMAIL_BASE_URL/api/v1/drive/spaces/account/uploads:initiate" \
  -H "Authorization: Bearer $TREKMAIL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: upload-report-001" \
  -d '{"name":"report.pdf","size_bytes":123456,"folder_id":42,"client_mime":"application/pdf"}'

TrekMail gibt Upload-Anweisungen zurück. Senden Sie die Bytes an die zurückgegebene Upload-URL und rufen Sie danach Folgendes auf:

curl -s -X POST "$TREKMAIL_BASE_URL/api/v1/drive/uploads/{FILE_ID}:complete" \
  -H "Authorization: Bearer $TREKMAIL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Wenn Sie MCP verwenden, bevorzugen Sie drive_file_upload. Das Tool bündelt Initiierung, Übertragung, Abschluss und Abbruch.

6. Freigabelink erstellen

curl -s -X POST "$TREKMAIL_BASE_URL/api/v1/drive/files/{FILE_ID}/share-links" \
  -H "Authorization: Bearer $TREKMAIL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: share-report-001" \
  -d '{"expires_at":"2026-06-01T00:00:00Z","max_downloads":25}'

Die zurückgegebene öffentliche URL ist die einzige Gelegenheit, bei der das rohe Link-Token angezeigt wird. Speichern Sie sie jetzt, falls Sie sie später senden müssen.

7. Audit-Trail prüfen

Öffnen Sie KI-Agenten & API → Audit-Protokoll und filtern Sie nach Token. Sie sollten Ordnererstellung, Upload, Abschluss und Erstellung des Freigabelinks sehen. So bestätigen Sie am schnellsten, dass Ihre Integration das erwartete Token und die vorgesehenen Berechtigungen verwendet.

Checkliste für die Produktion

• Verwenden Sie ein Token pro Integration.
• Gewähren Sie Lesen, Schreiben und Freigeben getrennt; halten Sie Purge aus täglichen Workflows heraus.
• Legen Sie Ablaufzeiten und Download-Limits für öffentliche Links fest.
• Verwenden Sie einen Idempotenzschlüssel, wenn die Endpunktdokumentation oder OpenAPI-Spezifikation dies verlangt. In diesem Ablauf betrifft das Ordnererstellung, Upload-Initiierung und Freigabelink-Erstellung.
• Widerrufen Sie Test-Tokens nach der Entwicklung.