Die Arbeit mit Umgebungen ist jetzt noch einfacher. Dieses Kinsta-API-Update führt neue Möglichkeiten ein, um Dateistrukturdaten abzurufen, selektive Dateipushs zwischen Umgebungen durchzuführen und alle Umgebungen in einer einzigen Anfrage abzurufen, wenn du Websites auflistest.

Diese Neuerungen sollen die Anzahl der Aufrufe reduzieren, damit deine Implementierungen und Entwicklungstools schneller und effizienter sind.

Dateiliste für eine Umgebung abrufen

Du kannst jetzt die vollständige Verzeichnisstruktur einer WordPress-Umgebung über die Kinsta-API abrufen. Dieser neue Endpunkt liefert eine rekursive Liste von Ordnern und Unterordnern, die dir einen klaren Überblick über den Inhalt jeder Umgebung gibt – ohne SSH-Anmeldung.

Das ist besonders nützlich, wenn du interne Tools erstellst, Dateipfade vor selektiven Bereitstellungen überprüfst oder Umgebungsaufgaben präzise automatisierst.

Du kannst eine Anfrage an GET senden:

GET /sites/environments/{env_id}/file-list

Hier ist ein Beispiel für eine Anfrage mit curl:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/file-list' \
  -H 'Authorization: Bearer '

Die Antwort enthält verschachtelte Objekte, die Verzeichnisse repräsentieren wie:

  • wp-content/
  • wp-content/plugins/
  • wp-content/themes/
  • wp-content/uploads/

Jeder Ordner enthält seinen Namen, den Pfad und alle Unterordner, so dass er leicht zugeordnet oder visualisiert werden kann.

Selektives Verschieben von Dateien zwischen Umgebungen

Der bestehende Push Environment Endpunkt unterstützt jetzt eine flexiblere Art und Weise, Dateiübertragungen zu verwalten. Mit zwei neuen optionalen Feldern kannst du entweder die gesamte Umgebung oder nur bestimmte Verzeichnisse übertragen – ideal für Workflows, bei denen du nicht alles synchronisieren möchtest.

Du kannst eine PUT Anfrage senden an:

PUT /sites/{site_id}/environments

Verwende die folgenden Felder, um festzulegen, welche Dateien einbezogen werden sollen:

  • push_files_option: Wähle zwischen "ALL_FILES" oder "SPECIFIC_FILES"
  • file_list: Gib eine Liste von Verzeichnispfaden an, die du pushen willst

Hier ist ein Beispiel, das curl benutzt, um nur ausgewählte Verzeichnisse von einer Umgebung in eine andere zu verschieben:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/{site_id}/environments' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_env_id": "your-source-env-id",
    "target_env_id": "your-target-env-id",
    "push_db": true,
    "push_files": true,
    "run_search_and_replace": true,
    "push_files_option": "SPECIFIC_FILES",
    "file_list": [
      "wp-content/plugins",
      "wp-content/themes",
      "wp-content/uploads"
    ]
  }'

Dieser selektive Ansatz ist hilfreich:

  • Verkürzung der Bereitstellungszeit, da nur das synchronisiert wird, was sich geändert hat
  • Das Überschreiben anderer Assets oder Uploads wird vermieden
  • Bessere Kontrolle beim Übertragen von Änderungen aus dem Staging in die Produktion

Wenn du push_files_option nicht angibst, wird standardmäßig "ALL_FILES" verwendet, um die Abwärtskompatibilität zu gewährleisten.

Websites und ihre Umgebungen in einem Aufruf auflisten

Du kannst jetzt alle Websites eines Unternehmens abrufen und ihre Umgebungen mit einem einzigen API-Aufruf abrufen. Wenn du den Abfrageparameter include_environments=true zum Endpunkt GET /sites hinzufügst, enthält die Antwort die zugehörigen Umgebungen der einzelnen Websites – separate Folgeanfragen sind nicht mehr nötig.

Dies ist besonders nützlich für Agenturen oder Teams, die eine große Anzahl von Websites verwalten, wo die Minimierung der API-Aufrufe und die Beschleunigung der Umgebungsprüfungen einen großen Unterschied machen können.

GET /sites?company=your-company-id&include_environments=true

Hier ist ein Beispiel für eine curl Anfrage:

curl -i -X GET \
'https://api.kinsta.com/v2/sites?company=your-company-id&include_environments=true' \
  -H 'Authorization: Bearer '

Die Antwort enthält Website-Metadaten (Name, ID usw.) und eine verschachtelte Liste von Umgebungen (staging, production, usw.).

Kinsta API: Entwickelt für Teams, die in großem Umfang verwalten

Diese API-Erweiterungen wurden entwickelt, um Zeit zu sparen und die Komplexität zu verringern, insbesondere für Entwickler und Agenturen, die Dutzende (oder Hunderte) von WordPress-Websites verwalten.

Ganz gleich, ob du ausgewählte Plugin-Dateien synchronisierst, interne Tools erstellst oder Umgebungen in einem Portfolio überprüfst, diese Verbesserungen helfen dir, die Arbeit zu rationalisieren, die du sonst manuell im Dashboard erledigen müsstest.

Du kannst diese neuen Funktionen in der Kinsta-API-Dokumentation nachlesen oder direkt in MyKinsta dein Zugangstoken generieren und loslegen.