Bisher haben sich unsere Dienste bei Kinsta auf manuelle Interaktionen über MyKinsta verlassen und den Umfang auf menschliche Interaktionen beschränkt. Aber halt dich gut fest, denn das wird sich jetzt ändern!

Wir führen die bahnbrechende Kinsta-API (Application Programming Interface) ein.

Verabschiede dich von den Einschränkungen der Vergangenheit und genieße eine revolutionäre Ära, in der Maschinen nahtlos mit unseren Diensten interagieren können. Das bedeutet, dass du jetzt Aufgaben auf deiner Kinsta-Website erledigen kannst, ohne dich bei MyKinsta einzuloggen.

Was mit der Kinsta-API möglich ist

Du kannst jetzt Aufgaben aus der Ferne mit unübertroffener Leichtigkeit und Effizienz erledigen. Hier sind die Anwendungsfälle für die Kinsta-API:

1. Berichterstattung

Mit der Kinsta-API kannst du die Kinsta-Dienste nahtlos in deine internen Tracking-Systeme integrieren. Egal, ob du eine Agentur bist, die alle WordPress-Websites, -Anwendungen und -Datenbanken deiner Kunden auflisten möchte, oder ein Datenenthusiast, der individuelle Dashboards erstellen will – mit unserer API kannst du mühelos Kinsta-Analysedaten abrufen.

2. Geplante Aufgaben

Mit der Kinsta-API kannst du Anwendungen zur Planung von Aufgaben erstellen, die die Leistung deiner Website nur minimal beeinträchtigen. Egal, ob du den Cache leerst oder wichtige Vorgänge ausführst, mit unserer API kannst du diese Aufgaben mühelos automatisieren.

3. WordPress-Seitenerstellung

Mit der Kinsta-API kannst du eine neue WordPress-Site/Installation automatisch erstellen. Du kannst auch die Kontrolle über die Funktionen deiner Website übernehmen, indem du beliebte Plugins wie WooCommerce und Yoast SEO direkt über die API installierst.

Aber das ist noch nicht alles! Mit der Kinsta API kannst du auch WordPress Multisite-Installationen erstellen und eine Subdomain (is_subdomain_multisite TRUE) oder ein Unterverzeichnis (is_subdomain_multisite FALSE) einrichten.

Erste Schritte mit der Kinsta-API

Um die Kinsta-API nutzen zu können, musst du ein aktives Konto bei Kinsta haben und mindestens eine WordPress-Seite, Anwendung oder Datenbank in MyKinsta haben. Außerdem musst du einen API-Key erstellen, um dich zu authentifizieren und auf dein Konto zuzugreifen.

Authentifizierung und Benutzerzugang

So generierst du einen API-Key:

  1. Gehe zu deinem MyKinsta-Dashboard.
  2. Navigiere zur Seite mit den API-Keys (Dein Name > Unternehmenseinstellungen > API-Key).
  3. Klicke auf API-Key erstellen.
  4. Wähle ein Ablaufdatum oder lege ein benutzerdefiniertes Startdatum und die Anzahl der Stunden fest, nach denen der Key abläuft.
  5. Gib dem Key einen eindeutigen Namen.
  6. Klicke auf Erzeugen.
API-Key auf MyKinsta erstellen.
API-Key auf MyKinsta erstellen.

Wenn du den API-Key erstellt hast, musst du ihn kopieren und an einem sicheren Ort aufbewahren, denn nur du kannst ihn dann sehen.

Du kannst mehrere API-Keys erstellen, die auf der Seite API-Keys aufgelistet sind. Wenn du einen API-Key widerrufen musst, klicke auf Widerruf neben dem Key, den du widerrufen möchtest.

Berechtigungen

Die Implementierung mehrerer Zugriffsstufen für API-Keys hilft dir, den Zugriff auf APIs zu kontrollieren. Bei Kinsta API hängt der Zugriff auf die API von der Rolle des Benutzers ab, da Firmeninhaber, Administratoren und Entwickler API-Keys erstellen können.

Ein API-Schlüssel, der von einem Unternehmensentwickler erstellt wurde, hat zum Beispiel nicht den gleichen Zugang wie ein Key, der von einem Unternehmenseigentümer oder Administrator erstellt wurde.

Genieße die Automatisierung mit der Kinsta API

Sobald du deinen API-Key hast, kannst du die Automatisierung mit der Kinsta-API nutzen. In der Kinsta-API-Referenzdokumentation findest du eine ausführliche Erläuterung der einzelnen Endpunkte, wie sie abgefragt werden können, die erforderlichen Parameter und mögliche Antworten sowie Beispiele für Anfragen und Antworten.

Um zum Beispiel eine Liste der Anwendungen deines Unternehmens abzurufen, verwende den applications Endpunkt. Dieser Endpunkt benötigt den Parameter company mit dem Wert deiner Unternehmens-ID (du kannst diese Informationen auf deiner Seite Rechnungsdetails in MyKinsta abrufen). Wenn du eine GET Anfrage an den Endpunkt (https://api.kinsta.com/v2/applications?company=UNIQUE_COMPANY_ID) sendest, werden JSON-Daten mit den Anwendungen deines Unternehmens zurückgegeben:

{
    "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"
                },
            ]
        }
    }
}

Es gibt noch mehr Möglichkeiten, die Kinsta-API zu nutzen, wie in der Kinsta-API-Referenzdokumentation beschrieben.

Vorgangsstatus prüfen

Bei potenziell langwierigen Vorgängen (z. B. Website-Erstellung, Löschen des Cache, Neustart von PHP usw.) antwortet die API nicht sofort mit dem Ergebnis. Dadurch wird verhindert, dass ein Server-Thread oder ein Gateway-Timeout blockiert wird, weil ein Vorgang lange dauert.

Um den Status eines Vorgangs zu überprüfen, verwende den Endpunkt operations. Dieser gibt den Status des Vorgangs zurück. Zum Beispiel:

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

Dieser operations, Endpunkt benötigt operation_id als Pfadparameter, den du in einer 202 Accepted Antwort erhältst, wenn du einen langwierigen Vorgang durchführst. Weitere Details und Beispiele findest du in der Referenz für Vorgänge.

Ratenbegrenzung

Um zu verhindern, dass unsere API mit zu vielen Anfragen überflutet wird, ist die Anzahl der Anfragen pro Minute auf 60 begrenzt. Die Ausnahme ist die Erstellung von Websites, die auf 5 Anfragen pro Minute begrenzt ist.

Um den aktuellen Status deines Ratenlimits zu sehen, überprüfe die RateLimit Header in deiner letzten API-Antwort:

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

Derzeit ist es nicht möglich, das Ratenlimit zu erhöhen.

Fehlersuche

Wenn du eine Anfrage an einen Endpunkt stellst, auf den dein API-Key keinen Zugriff hat, antwortet die API mit einer Fehlermeldung, um dir mitzuteilen, dass du keinen Zugriff hast. Wenn du Zugang zu diesem Endpunkt brauchst, kann ein Firmeninhaber oder Administrator einen API-Key für dich generieren.

Entfessle die Kraft der Automatisierung und steigere die Effizienz mit dem Komfort der Kinsta-API. Fange noch heute an!