De Plesk API maakt het mogelijk om taken in je hosting-omgeving te automatiseren zonder het controlepaneel handmatig te openen. Denk aan het aanmaken van domeinen, e-mailaccounts of backups via scripts. In dit artikel lees je hoe je een API-token aanmaakt, hoe je de eerste aanroepen doet en welke praktische automatiseringen je direct kunt toepassen.
Wat is de Plesk API
De Plesk API biedt programmatische toegang tot vrijwel alle functies van het controlepaneel: domeinen aanmaken, subdomeinen configureren, e-mailaccounts beheren, backups triggeren en meer. In plaats van elke handeling via de interface uit te voeren, stuur je een HTTP-verzoek dat Plesk direct verwerkt.
Dit is vooral waardevol voor wie veel klanten of domeinen beheert: nieuwe accounts kunnen automatisch worden aangemaakt zodra een bestelling binnenkomt, e-mailadressen worden direct klaargezet en je eigen systemen kunnen rechtstreeks met Plesk communiceren. Het resultaat is minder handwerk, minder fouten en processen die meeschalen met je klantenbestand.
Authenticatie en aan de slag
Voordat je de API kunt gebruiken, maak je een API-token aan in je Plesk-omgeving. Dit token stuur je vervolgens mee in elke aanroep ter authenticatie.
Maak een API-token aan
Log in op je Plesk-paneel, ga naar je profiel en open het onderdeel API-tokens. Klik op „Nieuw token“ en kopieer de gegenereerde waarde direct, want je ziet hem later niet meer terug.
Test de verbinding
Stuur met curl een eerste verzoek: curl -H "X-API-Key: JouwToken" https://jouw-server.com:8443/api/v1/domains. Krijg je een lijst met domeinen terug, dan werkt de koppeling.
Richt je ontwikkelomgeving in
Gebruik een REST-client zoals Postman om verzoeken te testen, en schrijf daarna scripts in bijvoorbeeld Python, PHP of Node.js voor structurele automatisering.
Praktische automatiseringsvoorbeelden
Een paar concrete toepassingen waarmee je direct aan de slag kunt:
Domein automatisch aanmaken: met een POST-verzoek naar /api/v1/domains en een body met onder meer de domeinnaam en het admin-ID richt je een nieuw domein in zonder het paneel te openen. Handig als je zelf domeinnamen registreert en direct wilt koppelen, zie ook domeinnamen.
E-mailaccounts beheren: via /api/v1/mail/mailboxes maak je automatisch postbussen aan zodra een nieuwe klant of medewerker wordt toegevoegd. Dit sluit goed aan bij zakelijke e-mail met correcte SPF, DKIM en DMARC-instellingen.
Backups triggeren: je kunt geplande backups opstarten of beheren via de backup-endpoints, zodat je eigen systeem bijhoudt wanneer een back-up is gelukt.
Webhooks en monitoring: koppel je eigen systeem aan gebeurtenissen in Plesk, zoals een verwijderd domein of een upgrade van een abonnement, zodat je direct kunt reageren zonder handmatig te controleren.
Beveiliging en beheer van tokens
Omdat een API-token volledige toegang kan geven tot je hostingomgeving, is zorgvuldig beheer belangrijk. Geef tokens alleen de rechten die nodig zijn, gebruik aparte tokens per systeem of integratie, en verwijder tokens die niet meer gebruikt worden. Controleer periodiek welke tokens actief zijn via je profiel in Plesk.
Loop je vast bij het opzetten van een integratie, dan vind je meer achtergrondartikelen in de kennisbank. Overweeg je over te stappen naar een provider waar Plesk standaard beschikbaar is op alle servers, bekijk dan de mogelijkheden om over te stappen naar Tandata.
Veelgestelde vragen
Is de Plesk API veilig?
Ja, de API werkt via HTTPS en tokengebaseerde authenticatie. Zorg wel dat je tokens veilig opslaat en alleen de benodigde rechten toekent.
Welke programmeertalen kan ik gebruiken?
Elke taal die HTTP-verzoeken kan versturen werkt, zoals Python, PHP, Node.js of Java. De API is niet gebonden aan één taal.
Kan ik ook backups automatiseren?
Ja, je kunt back-ups opstarten en beheren via de backup-endpoints van de API, zodat dit proces volledig geautomatiseerd verloopt.
Zijn er limieten op het aantal API-aanroepen?
Dit kan verschillen per Plesk-versie en configuratie. Raadpleeg de officiële Plesk-documentatie voor de actuele situatie op jouw omgeving.
Werkt de Plesk API op elke hostingomgeving?
De API is beschikbaar zodra Plesk is geïnstalleerd op de server. Controleer bij je provider of Plesk standaard is inbegrepen bij de webhosting.
Conclusie
Met de Plesk API automatiseer je repetitieve taken zoals het aanmaken van domeinen, e-mailaccounts en backups, zonder steeds het controlepaneel te openen. Begin met een goed beveiligd API-token, test eenvoudige verzoeken en bouw daarna stap voor stap scripts die jouw werkprocessen ondersteunen.