Overzicht van de TrekMail Drive-API voor ontwikkelaars

Met de TrekMail Drive-API kunnen vertrouwde toepassingen en AI-agents werken met dezelfde bestandsopslag die je in het dashboard en webmail ziet. Gebruik de API om mappen weer te geven, bestanden te uploaden, openbare downloadlinks te maken, prullenbakitems te herstellen, opslaggebruik te controleren en terugkerende bestandsworkflows te automatiseren zonder een agent toegang tot je hele account te geven.

Drive-automatisering maakt deel uit van de TrekMail REST API v1. De API gebruikt bearertokens, JSON-antwoorden, idempotentiebescherming wanneer het endpoint dit ondersteunt en hetzelfde auditspoor dat onder AI-agents en API → Auditlogboek wordt weergegeven. Het Drive-machtigingsmodel heeft 11 scopes, waaronder afzonderlijke scopes voor wachtwoorden van synchronisatieapparaten. Catalogi van endpoints en MCP-tools veranderen, dus gebruik de geretourneerde toollijst en API-antwoorden voor de actuele mogelijkheden die voor je token beschikbaar zijn.

Wat je kunt automatiseren

Veelvoorkomende Drive-API-taken zijn:

• Maandrapporten uploaden naar Account Drive.
• Een klantmap maken, bestanden toevoegen en één downloadlink delen.
• Een agent Drive-ruimtes van mailboxen laten doorzoeken en wijzigingen laten samenvatten.
• Oude bestanden naar een archiefmap verplaatsen.
• Bestanden uit de prullenbak herstellen na een onbedoelde opschoning.
• De status van de Drive-add-on lezen voordat een gebruiker wordt gewaarschuwd dat de opslag bijna vol is.

De API is bewust gericht op bestanden. De API vervangt het factureringsdashboard niet en biedt geen wijzigingen in betalingen of abonnementen.

Account Drive en Mailbox Drive

Drive heeft twee opslagomgevingen. Account Drive is de gedeelde bedrijfsruimte. Dit is doorgaans de juiste plek voor merkmateriaal, contracten, onboardingmateriaal en teammappen. Mailbox Drive is persoonlijke opslag die in webmail aan een mailbox is gekoppeld.

API-verzoeken identificeren het doel met de 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 kunnen tot specifieke mailboxen worden beperkt. Als een token beperkt is tot mailbox 42, geven verzoeken voor mailbox 99 een antwoord in de trant van "niet gevonden" in plaats van te onthullen dat de andere mailbox bestaat.

Verificatie en basis-URL

Gebruik een operationeel token in de Authorization-header:

Authorization: Bearer tm_live_your_token

Drive-endpoints bevinden zich onder:

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

Maak tokens vanuit AI-agents en API → Tokens. Kies alleen de Drive-scopes die je workflow nodig heeft.

De elf Drive-scopes

Uploads en grote bestanden

Uploads gebruiken een patroon in twee stappen. Eerst reserveert de API quotum en stuurt deze uploadinstructies terug. Je client stuurt vervolgens de bestandsbytes naar de upload-URL. Ten slotte markeert de API de upload als voltooid. Grote bestanden kunnen een meerdelige upload gebruiken en URL's van delen vernieuwen als een lange overdracht verloopt.

Voor de meeste AI-agents is de MCP-tool drive_file_upload eenvoudiger dan het rechtstreeks aanroepen van uploadendpoints op laag niveau. De tool verwerkt detectie van de bestandsgrootte, upload, voltooiing en afbreken bij fouten in één opdracht.

Deellinks

Deellinks maken openbare download-URL's voor afzonderlijke bestanden. Ze zijn nuttig als een bestand te groot is voor e-mail of als toegang ingetrokken moet kunnen worden. Stel waar mogelijk een vervaldatum en downloadlimiet in. Het onbewerkte linktoken wordt slechts eenmaal geretourneerd, bij het maken. Sla de geretourneerde URL dus direct op als je workflow deze nodig heeft.

Veilig verwijderen en wissen

Normale verwijderbewerkingen verplaatsen bestanden en mappen naar de prullenbak. Items blijven herstelbaar totdat ze worden hersteld, permanent gewist of verwijderd op basis van de bewaarregels van het product. Voor permanent wissen zijn wisscopes nodig, die in een afzonderlijk token moeten worden geïsoleerd.

Grens van de Drive-add-on

Agents kunnen de status, prijs en het annuleringsvoorbeeld van de Drive-add-on lezen met drive:addon:read. Het kopen, vergroten, verkleinen of annuleren van de Drive-add-on is niet beschikbaar via REST- of MCP-schrijftools. Deze handelingen blijven in het dashboard, zodat opslagfacturering een bewuste, door de gebruiker beheerste workflow blijft.