Snelstart voor de Drive-API voor ontwikkelaars

Deze snelstart toont de veiligste route van "Ik wil een integratie" naar een werkende Drive-API-aanroep. Je maakt een beperkt token, geeft Drive-ruimtes weer, uploadt één bestand en maakt een openbare deellink met vervaldatum.

1. Maak een Drive-token

Open AI-agents en API → Tokens → Token maken. Geef het token een duidelijke naam, zoals drive-report-uploader. Selecteer alleen de scopes die je workflow nodig heeft.

Gebruik voor deze handleiding:

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

Neem bij een eerste integratie geen purge-scopes op. Gebruik voor permanent verwijderen een apart onderhoudstoken.

Kopieer het token direct na het maken. TrekMail toont de leesbare waarde één keer en bewaart alleen een veilige hash.

2. Stel je basis-URL en token in

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

Elk verzoek gebruikt dezelfde bearer-header:

-H "Authorization: Bearer $TREKMAIL_API_TOKEN"

3. Geef beschikbare Drive-ruimtes weer

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

Het antwoord bevat Account Drive en alle mailbox-Drive-ruimtes die het token mag zien. Gebruik in de volgende voorbeelden account voor Account Drive.

4. Maak een map

Schrijfbewerkingen moeten een idempotentiesleutel bevatten. Als je netwerk het verzoek opnieuw probeert, kan TrekMail het oorspronkelijke resultaat teruggeven in plaats van duplicaten te maken.

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

Bewaar de geretourneerde map-ID.

5. Upload een bestand

De REST-API scheidt uploadonderhandeling van bestandsoverdracht. Start eerst de 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 retourneert uploadinstructies. Stuur de bytes naar de geretourneerde upload-URL en roep daarna aan:

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

Gebruik bij MCP bij voorkeur drive_file_upload. Deze tool bundelt initialiseren, overdragen, voltooien en afbreken.

6. Maak een deellink

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

De geretourneerde openbare URL is het enige moment waarop het onbewerkte linktoken wordt getoond. Bewaar hem nu als je hem later wilt verzenden.

7. Controleer het auditspoor

Open AI-agents en API → Auditlogboek en filter op token. Je moet de mapaanmaak, upload, voltooiing en deellinkaanmaak zien. Dit is de snelste manier om te bevestigen dat je integratie het verwachte token en de juiste scopes gebruikt.

Checklist voor productie

• Gebruik één token per integratie.
• Verleen lezen, schrijven en delen afzonderlijk; houd purge buiten dagelijkse workflows.
• Voeg een vervaldatum en downloadlimieten toe aan openbare links.
• Gebruik een idempotentiesleutel wanneer de endpointdocumentatie of OpenAPI-specificatie die vereist. In deze stroom geldt dat voor mapaanmaak, uploadinitialisatie en deellinkaanmaak.
• Trek testtokens na ontwikkeling in.