Altere Domínios Principais e Gerencie Acesso SFTP com a API da Kinsta

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.