Traditioneel leunden onze diensten bij Kinsta op handmatige interacties via MyKinsta, waardoor mogelijkheden werden beperkt tot uitsluitend menselijke interacties. Maar zet je schrap, want alles gaat veranderen!

We introduceren namelijk de baanbrekende Kinsta API (Application Programming Interface).

Zeg gedag tegen de beperkingen uit het verleden en profiteer van een revolutionair tijdperk waarin machines naadloos kunnen communiceren met onze diensten. Dit betekent dat je vanaf nu taken kunt uitvoeren op je Kinsta site zonder in te loggen op MyKinsta.

Wat wordt mogelijk met de Kinsta API

Je kunt nu taken op afstand uitvoeren met ongeëvenaard gemak en efficiëntie. Hier zijn de use cases van de Kinsta API:

1. Rapportage

Met Kinsta’s API kun je Kinsta diensten naadloos integreren in je interne trackingsysteem. Of je nu een bureau bent dat alle WordPress sites, applicaties en databases van je klanten wil inventariseren, of een dataliefhebber die aangepaste dashboards wil bouwen, met onze API kun je moeiteloos de Kinsta analytics gegevens ophalen.

2. Geplande taken

Geen late handmatige taken meer die de prestaties van je site beïnvloeden, want met de Kinsta API kun je applicaties maken om taken te plannen, zodat je bezoekers zo min mogelijk hinder ondervinden. Of het nu gaat om het wissen van de cache of het uitvoeren van kritieke operaties, met onze API kun je deze taken moeiteloos automatiseren.

3. WordPress sitecreatie

Met behulp van de Kinsta API kun je automatisch een nieuwe WordPress site/installatie aanmaken. Je kunt ook de functionaliteit van je site beheren door populaire plugins te installeren, zoals WooCommerce en Yoast SEO, rechtstreeks vanuit de API.

Maar dat is nog niet alles! Met Kinsta API kun je ook WordPress Multisite installaties maken en een subdomein (is_subdomain_multisite TRUE) of subdirectory (is_subdomain_multisite FALSE) installatie.

Aan de slag met Kinsta API

Om de Kinsta API te gaan gebruiken, moet je een actief account hebben op Kinsta met ten minste één WordPress site, applicatie of database in MyKinsta. Ook moet je een API sleutel genereren om je te authenticeren en toegang te krijgen tot je account.

Authenticatie en gebruikerstoegang

Om een API sleutel te genereren:

  1. Ga naar je MyKinsta dashboard.
  2. Navigeer naar de pagina API sleutels (Je naam > Bedrijfsinstellingen > API sleutels).
  3. Klik op API sleutel aanmaken.
  4. Kies een vervaldatum of stel een aangepaste begindatum en aantal uren in waarop de sleutel moet verlopen.
  5. Geef de sleutel een unieke naam.
  6. Klik op Genereren.
API sleutel aanmaken op MyKinsta.
API sleutel aanmaken op MyKinsta.

Wanneer de API sleutel is aangemaakt, zorg er dan voor dat je hem kopieert en ergens veilig bewaart, want dit is de enige keer dat je hem kunt zien.

Je kunt meerdere API sleutels genereren, en ze staan allemaal vermeld op de pagina API sleutels. Als je een API sleutel moet intrekken, klik je op Intrekken naast de sleutel die je wilt intrekken.

Rechten

Het invoeren van meerdere toegangsniveaus voor API-sleutels helpt je om de toegang tot API’s te beheren. Voor de Kinsta API hangt het toegangsniveau tot de API af van de rol van de gebruiker, aangezien Company Owners, Administrators en Developers API sleutels kunnen aanmaken.

Een API sleutel die is gegenereerd door een Company Developer zal niet dezelfde toegang hebben als een sleutel gegenereerd door een Company Owner of Company Administrator.

Profiteer van automatisering met Kinsta API

Zodra je je API sleutel hebt, kun je overgaan tot het profiteren van automatisering met de Kinsta API. De Kinsta API referentiedocumentatie biedt een gedetailleerde uitleg van elk eindpunt, hoe je ze kunt bevragen, de benodigde parameters en mogelijke antwoorden, samen met verzoek- en antwoordvoorbeelden.

Om bijvoorbeeld een lijst van de applicaties van je bedrijf op te vragen, gebruik je het applications eindpunt. Dit eindpunt vereist de parameter company met een waarde van je bedrijfs-ID (je kunt deze informatie krijgen op je pagina Factuurgegevens in MyKinsta). Wanneer je een GET verzoek naar het eindpunt (https://api.kinsta.com/v2/applications?company=UNIQUE_COMPANY_ID) stuurt, zal het JSON gegevens terugsturen die de applicaties van je bedrijf bevatten:

{
    "company": {
        "apps": {
            "items": [
                {
                    "id": "ccd26ccb-8e78-4cf0-a5b2-2ab5d1a23760",
                    "name": "chatgpt-clone-g9q10",
                    "display_name": "chatgpt-clone",
                    "status": "deploymentSuccess"
                },
                {
                    "id": "1adf1e9c-f35e-491e-bec9-fe00ad9f2086",
                    "name": "kinsta-developer-portfolio-ir8w8",
                    "display_name": "Kinsta-developer-portfolio",
                    "status": "deploymentSuccess"
                },
            ]
        }
    }
}

Er is meer mogelijk met de Kinsta API, zoals gedocumenteerd in de Kinsta API referentiedocumentatie.

Operationele status controleren

Voor mogelijk langlopende operaties (bijv. sitecreatie, cache wissen, PHP herstarten, etc.) reageert de API niet onmiddellijk met het resultaat. Dit helpt een mogelijke geblokkeerde server thread of gateway timeout te voorkomen omdat een bewerking lang duurt.

Om de status van een operatie te controleren, gebruik je het operations eindpunt. Dit geeft de status van de operatie terug. Bijvoorbeeld:

{
  "status": 202,
  "message": "Operation in progress",
  "data": null
}

Dit operations, eindpunt vereist de operation_id als padparameter, die je krijgt in een 202 Accepted antwoord als je een langlopende bewerking uitvoert. Voor meer details en voorbeelden, zie de operations referentie.

Snelheidslimiet

Om te voorkomen dat onze API wordt overspoeld met te veel verzoeken, is het aantal verzoeken per minuut beperkt tot 60. De uitzondering is het aanmaken van sites, dat beperkt is tot 5 verzoeken per minuut.

Om je huidige rate limit status te zien, controleer je de RateLimit headers in je meest recente API respons:

RateLimit-Limit: 60
RateLimit-Remaining: 50
RateLimit-Reset: 60

Momenteel is het niet mogelijk om deze limiet te verhogen.

Problemen oplossen

Als je een verzoek doet naar een eindpunt waartoe je API sleutel geen toegang heeft, reageert de API met een foutmelding om je te laten weten dat je geen toegang hebt. Als je toegang tot dat eindpunt nodig hebt, kan een Company Owner of Company Administrator een API sleutel voor je genereren.

Ontketen de kracht van automatisering en verhoog de efficiëntie met het gemak van de Kinsta API. Ga vandaag nog aan de slag!