Die API von Kinsta hat gerade eine Reihe von Updates erhalten, die Entwicklern und Website-Betreibern mehr Kontrolle darüber geben, wie ihre Websites am Rand und hinter den Kulissen funktionieren.

Ganz gleich, ob du Automatisierungsskripte entwickelst oder benutzerdefinierte Tools für deine Umgebung erstellst, diese Neuerungen machen es einfacher, das CDN-Verhalten, die Cache-Einstellungen und PHP-Versions-Updates präzise zu steuern.

Kontrolle der Bildoptimierung

Du kannst jetzt die Einstellungen für die Bildoptimierung für jede Umgebung über die Kinsta-API verwalten. Dieser neue Endpunkt gibt Entwicklern die Flexibilität, die Einstellungen, wie Kinsta Bilder komprimiert und bereitstellt, anzupassen, ohne dass sie sich bei MyKinsta anmelden müssen.

Dies ist besonders nützlich, wenn du die Bereitstellung automatisierst oder mehrere Umgebungen in großem Umfang verwaltest. Abhängig von deinem Anwendungsfall kannst du einen der folgenden Optimierungsmodi wählen:

  • off – Deaktiviert die Bildoptimierung vollständig.
  • lossy – Wendet eine aggressive Komprimierung an, um die Dateigröße zu verringern und die Ladezeiten zu verkürzen, allerdings auf Kosten der visuellen Qualität.
  • lossless – Komprimiert die Bilder ohne Qualitätseinbußen, so dass die Schärfe erhalten bleibt und die Dateigröße trotzdem reduziert wird.

Um die Einstellung der Bildoptimierung für eine Umgebung zu aktualisieren, sende eine Anfrage an PUT:

PUT /sites/cdn/image-optimization

Dein Anfragetext sollte die environment_id und die gewünschte Optimierungsart enthalten. Hier ist ein kurzes Beispiel, in dem curl verwendet wird, um eine verlustbehaftete Optimierung durchzuführen:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/cdn/image-optimization \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "image_optimization_type": "lossy"
  }'

Dieses Update gibt dir mehr Kontrolle darüber, wie Medieninhalte ausgeliefert werden – ideal, um die Leistung in Produktions-, Staging- oder medienintensiven Umgebungen anzupassen.

Weitere Informationen darüber, wie die Bildoptimierung bei Kinsta funktioniert, findest du in unserer CDN-Dokumentation.

Aktiviere oder deaktiviere das Edge Caching

Über die Kinsta-API kannst du jetzt das Edge Caching für eine bestimmte Umgebung ein- und ausschalten. Mit diesem neuen Endpunkt kannst du das Edge-Caching programmatisch aktivieren oder deaktivieren und hast so mehr Kontrolle darüber, wie Inhalte über das globale CDN von Kinsta bereitgestellt werden.

Dies ist besonders nützlich bei der Bereitstellung, beim Testen oder bei der Fehlerbehebung, wenn du zwischengespeicherte Inhalte vorübergehend umgehen oder wiederherstellen musst.

Du kannst eine Anfrage an PUT senden:

PUT /sites/edge-caching/status

Füge das Feld environment_id und ein boolesches Feld enabled in den Request Body ein. Hier ist ein Beispiel für eine Anfrage mit curl, um Edge Caching zu aktivieren:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/edge-caching/status \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "enabled": true
  }'

Wenn du "enabled" auf false setzt, wird das Edge Caching für diese Umgebung deaktiviert. Dies ist hilfreich, wenn du aktiv Updates einspielst und Verzögerungen beim Caching vermeiden willst.

Automatische PHP-Updates abbestellen

Wir haben die Kinsta-API um eine neue Kontrollebene für die Verwaltung von PHP-Versionen erweitert. Wenn du die PHP-Version einer Umgebung änderst, kannst du jetzt das optionale Flag is_opt_out_from_automatic_php_update angeben, um zukünftige automatische Upgrades abzulehnen.

Dieses Update ist vor allem für Teams hilfreich, die die Versionskonsistenz in verschiedenen Umgebungen aufrechterhalten oder Aktualisierungen verzögern müssen, um die Kompatibilität mit benutzerdefiniertem Code, Plugins oder alten Abhängigkeiten zu gewährleisten.

Sende eine PUT Anfrage an:

PUT /sites/tools/modify-php-version

Die Anfrage sollte deine Umgebungs-ID, die Ziel-PHP-Version und das neue is_opt_out_from_automatic_php_update-Flag, das auf true oder false gesetzt ist, enthalten. Hier ist ein Beispiel für eine curl-Anfrage:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/tools/modify-php-version \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "php_version": "8.1",
    "is_opt_out_from_automatic_php_update": true
  }'

Wenn du dieses Flag auf true setzt, bleibt deine Umgebung auf der ausgewählten PHP-Version, es sei denn, du aktualisierst sie manuell über die API oder im MyKinsta-Dashboard. Wenn das Flag weggelassen oder auf false gesetzt wird, folgt die Umgebung dem standardmäßigen Auto-Update-Zeitplan von Kinsta für unterstützte PHP-Versionen.

Weitere Informationen findest du in unserer PHP-Verwaltungsdokumentation.

Neue Felder in den Umgebungsantworten

Der Endpunkt GET /sites/{site_id}/environments liefert jetzt zwei zusätzliche Felder, die einen besseren Einblick in die Konfiguration der einzelnen Umgebungen ermöglichen:

  • image_optimization_type – Zeigt die aktuelle Einstellung für die Bildoptimierung an, die über das CDN angewendet wird. Dies kann "off", "lossy" oder "lossless" sein und hilft dir, die Optimierungsstufen in den verschiedenen Umgebungen auf einen Blick zu erkennen.
  • is_opt_out_from_automatic_php_update – Zeigt an, ob automatische PHP-Updates für die Umgebung deaktiviert sind. Bei der Einstellung true erhält die Umgebung keine geplanten PHP-Upgrades.

Diese Verbesserung macht es einfacher, umgebungsspezifische Einstellungen programmatisch zu überprüfen und zu verwalten, was besonders für Teams nützlich ist, die mit Staging-, Entwicklungs- und Produktionsinstanzen arbeiten.

Hier ist ein vereinfachtes Beispiel für ein Antwort-Snippet:

{
  "id": "your-environment-id",
  "name": "production",
  "image_optimization_type": "lossy",
  "is_opt_out_from_automatic_php_update": true
}

Weitere Informationen findest du in unserer API-Referenz für Umgebungsendpunkte.

Warum das wichtig ist

Bei diesen Updates geht es darum, dir mehr Kontrolle zu geben, besonders wenn du mehrere Umgebungen verwaltest oder deinen Arbeitsablauf automatisierst.

  • Feinabstimmung der Bildleistung, ohne dich im Dashboard anzumelden.
  • Verwalte das Edge Caching Verhalten direkt über die API, was ideal für Deployment Pipelines ist.
  • Sicherstellung der PHP-Versionskompatibilität durch Sperren von Umgebungen auf eine bestimmte Version bei Bedarf.
  • Überprüfe die Umgebungseinstellungen in großem Umfang mit neuen Antwortfeldern.

Diese Änderungen erleichtern es  dir mit Kinsta zu deinen Bedingungen zu arbeiten und die Werkzeuge und Automatisierungen zu nutzen, die bereits für dein Team funktionieren.

Alle Details zu Anfragen und Antworten findest du in der Kinsta-API-Dokumentation.