Expandimos a API da Kinsta com novos recursos de gerenciamento de domínio e usuário, dando às equipes ainda mais controle sobre seus ambientes, sem a necessidade de fazer login no MyKinsta.
Com essas atualizações, agora você pode alterar programaticamente o domínio principal de um ambiente WordPress e gerenciar totalmente contas SFTP adicionais por meio da API da Kinsta.
Alterar o domínio principal de um ambiente
Anteriormente, a API da Kinsta permitia que você adicionasse ou removesse domínios do seu site, o que era ótimo para configuração e limpeza. Mas você não podia alterar qual domínio foi definido como principal para um ambiente.
Com esta nova versão, agora você pode definir um domínio existente como o novo domínio primário para um ambiente específico usando o seguinte endpoint:
PUT /sites/environments/{env_id}/change-primary-domain
Para usar o endpoint, você precisa do endereço domain_id
do domínio que deseja definir como principal. Ele deve ser um dos domínios já associados ao ambiente.
Você pode encontrar o domain_id
usando os endpoints Get Site by ID
ou Get Site Environments
. A resposta será algo como:
"domains": [
{
"id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
"name": "example.com",
"type": "live"
}
]
Também é necessário definir o campo run_search_and_replace
. Quando definido como true
, ele executa uma busca e substituição no banco de dados do site para atualizar URLs que fazem referência ao domínio.
Aqui está um exemplo usando 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
}'
Suporte completo para gerenciar contas SFTP adicionais
Em abril, adicionamos a capacidade de criar e gerenciar várias contas de usuário SFTP diretamente no painel MyKinsta. Agora, você pode fazer tudo isso usando a API da Kinsta.
Isso dá a você controle programático total sobre usuários SFTP adicionais em cada ambiente. Você pode habilitar o acesso, adicionar novos usuários, listar os existentes ou removê-los completamente.
Habilitar ou desabilitar o acesso
Antes de adicionar qualquer usuário, o acesso SFTP adicional deve ser habilitado para o ambiente. Você pode fazer isso com:
PUT /sites/environments/{env_id}/additional-sftp-accounts/toggle-status
Aqui está um exemplo usando 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
}'
Isso pode ser revertido a qualquer momento, definindo "enabled": false
.
Adicionar um novo usuário SFTP
Uma vez habilitado, você pode adicionar usuários com o seguinte endpoint:
POST /sites/environments/{env_id}/additional-sftp-accounts
A solicitação permite que você defina um nome de usuário, senha segura (mínimo de 16 caracteres), diretório raiz e nível de permissão (read
ou 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"
}'
Isso reflete os mesmos controles que você encontraria no MyKinsta, incluindo a capacidade de restringir o acesso a diretórios específicos ou atribuir permissões somente leitura.
Listar e remover usuários
Você pode recuperar uma lista de contas SFTP adicionais como esta:
GET /sites/environments/{env_id}/additional-sftp-accounts
Para excluir uma:
DELETE /sites/environments/additional-sftp-accounts/{sftp_account_id}
Isso oferece flexibilidade total para automatizar a rotação de contas, conceder acesso limitado a colaboradores ou revogar credenciais após uma implantação.
Novos metadados nas listagens de ambiente
Para dar suporte a esses novos recursos, adicionamos o campo is_additional_sftp_accounts_enabled
aos seguintes endpoints:
- GET /sites/{site_id}/environments
- GET /sites (ao usar o parâmetro de consulta
include_environments=true
)
Isso facilita a auditoria de quais ambientes possuem acesso SFTP adicional habilitado, especialmente se você gerencia muitos sites em sua plataforma ou contas de clientes.
Mais controle para equipes modernas
Esses novos recursos da API proporcionam um controle mais profundo sobre a sua infraestrutura, quer você esteja automatizando fluxos de trabalho de ambiente de teste, alternando credenciais SFTP ou trocando URLs de sites de forma programática.
Você pode encontrar todos os detalhes de solicitação/resposta na documentação da API da Kinsta. Você pode fazer muita coisa com a API da Kinsta, e muitas agências e desenvolvedores já confiam nela para gerenciar centenas de sites com eficiência.
Você está pronto para começar? Vá até o MyKinsta para gerar seu token API e começar a criar.