Vi har udvidet Kinsta API med nye domæne- og brugerstyringsfunktioner, der giver teams endnu mere kontrol over deres miljøer uden at skulle logge ind på MyKinsta.

Med disse opdateringer kan du nu programmatisk ændre det primære domæne i et WordPress-miljø og fuldt ud administrere yderligere SFTP-konti via Kinsta API.

Skift det primære domæne i et miljø

Tidligere gav Kinsta API dig mulighed for at tilføje eller fjerne domæner fra dit websted, hvilket var fantastisk til opsætning og oprydning. Men du kunne ikke ændre, hvilket domæne der var indstillet som primært for et miljø.

Med denne nye udgivelse kan du nu indstille et eksisterende domæne som det nye primære domæne for et specifikt miljø ved hjælp af følgende endpoint:

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

For at bruge endpointet skal du bruge domain_id for det domæne, du vil indstille som primært. Det skal være et af de domæner, der allerede er tilknyttet miljøet.

Du kan finde domain_id ved hjælp af Get Site by ID eller Get Site Environments endpoints. Det ser nogenlunde sådan ud i svaret:

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

Du skal også indstille feltet run_search_and_replace. Når det er indstillet til true, udløser det en søgning og udskiftning på tværs af webstedets database for at opdatere URL’er, der henviser til domænet.

Her er et eksempel med 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
  }'

Fuld understøttelse af administration af yderligere SFTP-konti

I april tilføjede vi muligheden for at oprette og administrere flere SFTP-brugerkonti direkte i MyKinsta-dashboardet. Nu kan du gøre alt dette ved hjælp af Kinsta API.

Dette giver dig fuld programmatisk kontrol over yderligere SFTP-brugere i hvert miljø. Du kan aktivere adgang, tilføje nye brugere, liste eksisterende eller fjerne dem helt.

Aktiver eller deaktiver adgang

Før du tilføjer brugere, skal yderligere SFTP-adgang aktiveres for miljøet. Det kan du gøre med:

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

Her er et eksempel med 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
  }'

Dette kan til enhver tid vendes ved at indstille "enabled": false.

Tilføj en ny SFTP-bruger

Når det er aktiveret, kan du tilføje brugere med dette endpoint:

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

Anmodningen giver dig mulighed for at definere et brugernavn, en sikker adgangskode (mindst 16 tegn), en rodmappe og et tilladelsesniveau (read eller write).

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"
  }'

Dette afspejler de samme kontroller, som du finder i MyKinsta, herunder muligheden for at begrænse adgangen til bestemte mapper eller tildele skrivebeskyttede tilladelser.

Vis og fjern brugere

Du kan hente en liste over yderligere SFTP-konti på denne måde:

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

For at slette en:

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

Det giver dig fuld fleksibilitet til at automatisere kontorotation, give begrænset adgang til samarbejdspartnere eller tilbagekalde legitimationsoplysninger efter en udrulning.

Nye metadata i miljøfortegnelser

For at understøtte disse nye muligheder har vi tilføjet feltet is_additional_sftp_accounts_enabled til følgende endpoints:

Det gør det lettere at kontrollere, hvilke miljøer der har ekstra SFTP-adgang aktiveret, især hvis du administrerer mange på tværs af din platform eller kundekonti.

Mere kontrol til moderne teams

Disse nye API-funktioner giver dig dybere kontrol over din infrastruktur, uanset om du automatiserer staging-workflows, roterer SFTP-legitimationsoplysninger eller programmatisk skifter websteds-URL’er.

Du kan finde alle detaljer om anmodning/svar i Kinsta API-dokumentationen. Der er meget, du kan gøre med Kinsta API, og mange agenturer og udviklere er allerede afhængige af det til at administrere hundredvis af websteder effektivt.

Er du klar til at komme i gang? Gå til MyKinsta for at generere dit API-token og begynde at bygge.