Wir haben die Kinsta-API um neue Funktionen für die Domain- und Benutzerverwaltung erweitert, die Teams noch mehr Kontrolle über ihre Umgebungen geben, ohne dass sie sich bei MyKinsta anmelden müssen.

Mit diesen Updates kannst du jetzt die primäre Domain einer WordPress-Umgebung programmatisch ändern und zusätzliche SFTP-Konten vollständig über die Kinsta-API verwalten.

Ändern der primären Domain einer Umgebung

Bisher konntest du mit der Kinsta-API Domains zu deiner Website hinzufügen oder entfernen, was für die Einrichtung und Bereinigung sehr praktisch war. Aber du konntest nicht ändern, welche Domain für eine Umgebung als primär festgelegt wurde.

Mit der neuen Version kannst du jetzt eine bestehende Domain als neue primäre Domain für eine bestimmte Umgebung festlegen, indem du den folgenden Endpunkt verwendest:

PUT /sites/environments/{env_id}/change-primary-domain

Um den Endpunkt zu verwenden, brauchst du die domain_id der Domain, die du als primär festlegen möchtest. Dies muss eine der Domains sein, die bereits mit der Umgebung verbunden sind.

Du findest die domain_id mit den Befehlen Get Site by ID oder Get Site Environments Endpunkte. Die Antwort sieht ungefähr so aus:

"domains": [
  {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "name": "example.com",
    "type": "live"
  }
]

Du musst auch das Feld run_search_and_replace setzen. Wenn es auf true gesetzt ist, löst es ein Suchen und Ersetzen in der Datenbank der Website aus, um URLs zu aktualisieren, die auf die Domain verweisen.

Hier ist ein Beispiel mit curl:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/change-primary-domain' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain_id": "your-domain-id",
    "run_search_and_replace": true
  }'

Volle Unterstützung für die Verwaltung zusätzlicher SFTP-Konten

Im April haben wir die Möglichkeit hinzugefügt, mehrere SFTP-Benutzerkonten direkt im MyKinsta-Dashboard zu erstellen und zu verwalten. Jetzt kannst du das alles über die Kinsta-API machen.

Damit hast du die volle programmatische Kontrolle über zusätzliche SFTP-Benutzer in jeder Umgebung. Du kannst den Zugang aktivieren, neue Benutzer hinzufügen, bestehende Benutzer auflisten oder sie ganz entfernen.

Aktivieren oder Deaktivieren des Zugangs

Bevor du Benutzer hinzufügen kannst, muss der zusätzliche SFTP-Zugang für die Umgebung aktiviert werden. Das kannst du so erreichen:

PUT /sites/environments/{env_id}/additional-sftp-accounts/toggle-status

Hier ist ein Beispiel mit curl:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/additional-sftp-accounts/toggle-status' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "enabled": true
  }'

Dies kann jederzeit durch die Einstellung "enabled": false rückgängig gemacht werden.

Einen neuen SFTP-Benutzer hinzufügen

Nach der Aktivierung kannst du Benutzer mit diesem Endpunkt hinzufügen:

POST /sites/environments/{env_id}/additional-sftp-accounts

In der Anfrage kannst du einen Benutzernamen, ein sicheres Passwort (mindestens 16 Zeichen), ein Stammverzeichnis und eine Berechtigungsstufe (read oder write) festlegen.

curl -i -X POST \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/additional-sftp-accounts' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "dev-user",
    "password": "R8zXwT@#bV!kJq9^",
    "root_directory": "/wp-content/themes",
    "permission": "write"
  }'

Dies spiegelt die gleichen Kontrollen wider, die du auch in MyKinsta findest, einschließlich der Möglichkeit, den Zugriff auf bestimmte Verzeichnisse zu beschränken oder nur Leserechte zu vergeben.

Benutzer auflisten und entfernen

Du kannst eine Liste zusätzlicher SFTP-Konten wie folgt abrufen:

GET /sites/environments/{env_id}/additional-sftp-accounts

Um eins zu löschen:

DELETE /sites/environments/additional-sftp-accounts/{sftp_account_id}

So hast du die volle Flexibilität, die Kontorotation zu automatisieren, Mitarbeitern begrenzten Zugriff zu gewähren oder Anmeldedaten nach einem Einsatz zu widerrufen.

Neue Metadaten in Umgebungsauflistungen

Um diese neuen Möglichkeiten zu unterstützen, haben wir das Feld is_additional_sftp_accounts_enabled zu den folgenden Endpunkten hinzugefügt:

So kannst du leichter überprüfen, in welchen Umgebungen zusätzlicher SFTP-Zugang aktiviert ist, vor allem, wenn du viele über deine Plattform oder Kundenkonten hinweg verwaltest.

Mehr Kontrolle für moderne Teams

Mit diesen neuen API-Funktionen hast du mehr Kontrolle über deine Infrastruktur, ganz gleich, ob du Staging-Workflows automatisierst, SFTP-Zugangsdaten rotieren lässt oder URLs von Websites programmatisch umschaltest.

Alle Details zu den Anfragen und Antworten findest du in der Kinsta-API-Dokumentation. Mit der Kinsta-API kannst du eine Menge anstellen, und viele Agenturen und Entwickler nutzen sie bereits, um Hunderte von Websites effizient zu verwalten.

Bist du bereit, loszulegen? Geh zu MyKinsta, um dein API-Token zu generieren und mit dem Aufbau zu beginnen.