Vi har utökat Kinsta API med nya domän- och användarhanteringsfunktioner. Som ett resultat får team ännu mer kontroll över sina miljöer. De behöver dessutom inte logga in på MyKinsta.
Med dessa uppdateringar kan du nu programmatiskt ändra den primära domänen i en WordPress-miljö. Du kan dessutom helt hantera ytterligare SFTP-konton via Kinsta API.
Ändra den primära domänen för en miljö
Tidigare tillät Kinsta API dig att lägga till eller ta bort domäner från din webbplats. Detta var exempelvis bra för installation och rengöring. Du kunde dock inte ändra vilken domän som var inställd som primär för en miljö.
Som ett resultat av den här nya versionen kan du nu ställa in en befintlig domän som den nya primära domänen för en specifik miljö med hjälp av följande slutpunkt:
PUT /sites/environments/{env_id}/change-primary-domain
För att använda slutpunkten behöver du domain_id
för den domän som du vill ange som primär. Detta måste dessutom vara en av de domäner som redan är associerade med miljön.
Du kan hitta domain_id
med hjälp av Get Site by ID
eller Get Site Environments
-slutpunkterna. Det ser ut ungefär så här i svaret:
"domains": [
{
"id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
"name": "example.com",
"type": "live"
}
]
Du måste dessutom ställa in fältet run_search_and_replace
. När det är inställt på true
utlöser det en sökning och ersättning över webbplatsens databas för att uppdatera webbadresser som hänvisar till domänen.
Här är ett exempel som använder 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
}'
Fullt stöd för att hantera ytterligare SFTP-konton
I april lade vi dessutom till möjligheten att skapa och hantera flera SFTP-användarkonton direkt i MyKinsta-panelen. Som ett resultat kan du nu göra allt detta med hjälp av Kinsta API.
Detta ger dig full programmatisk kontroll över ytterligare SFTP-användare i varje miljö. Du kan exempelvis aktivera åtkomst, lägga till nya användare, lista befintliga eller ta bort dem helt.
Aktivera eller inaktivera åtkomst
Innan du lägger till några användare måste ytterligare SFTP-åtkomst aktiveras för miljön. Det kan du exempelvis göra med:
PUT /sites/environments/{env_id}/additional-sftp-accounts/toggle-status
Här är ett exempel 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
}'
Detta kan återställas när som helst genom att ställa in "enabled": false
.
Lägga till en ny SFTP-användare
När den är aktiverad kan du lägga till användare med den här slutpunkten:
POST /sites/environments/{env_id}/additional-sftp-accounts
I begäran kan du ange ett användarnamn, ett säkert lösenord (minst 16 tecken), en rotkatalog och en behörighetsnivå (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"
}'
Detta speglar samma kontroller som du hittar i MyKinsta. Det inkluderar dessutom möjligheten att begränsa åtkomsten till specifika kataloger eller tilldela skrivskyddade behörigheter.
Lista och ta bort användare
Du kan hämta en lista över ytterligare SFTP-konton så här:
GET /sites/environments/{env_id}/additional-sftp-accounts
För att ta bort ett:
DELETE /sites/environments/additional-sftp-accounts/{sftp_account_id}
Detta ger dig full flexibilitet att automatisera kontorotation, ge begränsad åtkomst till medarbetare eller återkalla autentiseringsuppgifter efter en distribuering.
Nya metadata i miljöförteckningar
För att stödja dessa nya funktioner har vi lagt till fältet is_additional_sftp_accounts_enabled
i följande slutpunkter:
- GET /sites/{site_id}/environments
- GET /sites (när du använder frågeparametern
include_environments=true
)
Som ett resultat blir det enklare att granska vilka miljöer som har ytterligare SFTP-åtkomst aktiverad, särskilt om du hanterar många över din plattform eller dina kundkonton.
Mer kontroll för moderna team
Dessa nya API-funktioner ger dig djupare kontroll över din infrastruktur, oavsett om du automatiserar arbetsflöden för iscensättning, roterar SFTP-autentiseringsuppgifter eller programmatiskt byter webbadresser för webbplatser.
Du kan hitta alla begäranden/svarsdetaljer i Kinsta API-dokumentationen. Det finns mycket som du kan göra med Kinsta API, och många agenturer och utvecklare förlitar sig redan på detta för att hantera hundratals webbplatser effektivt.
Är du redo att komma igång? Gå till MyKinsta för att generera din API-token och börja bygga.