A API da Kinsta acaba de receber um novo conjunto de atualizações que oferece aos desenvolvedores e gerenciadores de sites mais controle sobre o desempenho de seus sites na borda e nos bastidores.

Seja você responsável por scripts de automação ou pela criação de ferramentas personalizadas para o seu ambiente, essas adições facilitam o gerenciamento preciso do comportamento do CDN, configurações de cache e atualizações da versão do PHP.

Controle a otimização de imagens

Agora você pode gerenciar as configurações de otimização de imagem para qualquer ambiente usando a API da Kinsta. Esse novo endpoint oferece aos desenvolvedores a flexibilidade de ajustar como a Kinsta comprime e entrega imagens, tudo isso sem precisar acessar o painel MyKinsta.

Isso é especialmente útil se você estiver automatizando implantações ou gerenciando vários ambientes em escala. Dependendo do seu caso de uso, você pode escolher um dos seguintes modos de otimização:

  • off – Desativa totalmente a otimização da imagem.
  • lossy – Aplica uma compressão agressiva para obter tamanhos de arquivo menores e tempos de carregamento mais rápidos, ao custo de alguma fidelidade visual.
  • lossless – Comprime as imagens sem reduzir a qualidade, preservando a nitidez e, ao mesmo tempo, reduzindo o tamanho do arquivo.

Para atualizar a configuração de otimização de imagem de um ambiente, envie uma solicitação PUT para:

PUT /sites/cdn/image-optimization

O corpo da sua solicitação deve incluir o endereço environment_id e o tipo de otimização desejado. Aqui está um exemplo rápido usando curl para aplicar otimização com perdas:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/cdn/image-optimization \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "image_optimization_type": "lossy"
  }'

Essa atualização oferece a você mais controle sobre como os ativos de mídia são fornecidos, o que é ideal para personalizar o desempenho em ambientes de produção, ambiente de teste ou com muita mídia.

Para obter mais informações sobre como a otimização de imagens funciona na Kinsta, consulte nossa documentação de CDN.

Habilite ou desabilite o Edge Caching

Agora você pode habilitar ou desabilitar o Edge Caching para um ambiente específico usando a API da Kinsta. Esse novo endpoint permite controlar programaticamente o Edge Caching, oferecendo mais controle sobre como o conteúdo é entregue por meio do CDN global da Kinsta.

Isso é especialmente útil durante implantações, testes ou cenários de solução de problemas (troubleshooting), quando é necessário ignorar temporariamente ou restabelecer o conteúdo armazenado em cache.

Você pode enviar uma requisição PUT para:

PUT /sites/edge-caching/status

Inclua o environment_id e um campo booleano enabled no corpo da solicitação. Aqui está um exemplo de solicitação usando curl para habilitar o Edge Caching:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/edge-caching/status \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "enabled": true
  }'

Ao definir "enabled" como false, você desabilita o Edge Caching para esse ambiente. Isso é útil se você estiver enviando atualizações ativamente e quiser evitar atrasos no armazenamento em cache.

Desabilite as atualizações automáticas do PHP

A API da Kinsta agora oferece mais controle para o gerenciamento de versões do PHP. Ao modificar a versão do PHP de um ambiente, você pode incluir a flag opcional is_opt_out_from_automatic_php_update para desabilitar atualizações automáticas futuras.

Isso é especialmente útil para equipes que precisam manter consistência entre ambientes ou adiar atualizações para garantir compatibilidade com código personalizado, plugins ou dependências legadas.

Envie uma requisição PUT para:

PUT /sites/tools/modify-php-version

O corpo da solicitação deve incluir o ID do seu ambiente, a versão do PHP de destino e o novo sinalizador is_opt_out_from_automatic_php_update definido como true ou false. Aqui está um exemplo de solicitação curl:

curl -i -X PUT \
  https://api.kinsta.com/v2/sites/tools/modify-php-version \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment_id": "your-environment-id",
    "php_version": "8.1",
    "is_opt_out_from_automatic_php_update": true
  }'

Definir esse sinalizador (flag) como true mantém seu ambiente na versão PHP selecionada, a menos que você o atualize manualmente por meio da API ou no painel MyKinsta. Se o sinalizador for omitido ou definido como false, o ambiente seguirá a programação de atualização automática padrão da Kinsta para as versões PHP suportadas.

Para obter mais informações, você pode consultar nossa documentação de gerenciamento de PHP.

Novos campos nas respostas do ambiente

O endpoint GET /sites/{site_id}/environments agora retorna dois campos adicionais que fornecem melhor visibilidade sobre como cada ambiente está configurado:

  • image_optimization_type – Mostra a configuração de otimização de imagens aplicada via CDN. Pode ser "off", "lossy" ou "lossless", permitindo verificar rapidamente os níveis de otimização em todos os ambientes.
  • is_opt_out_from_automatic_php_update – Indica se as atualizações automáticas do PHP estão desativadas para o ambiente. Se você definir como true, o ambiente não receberá atualizações programadas do PHP.

Esse aprimoramento facilita a auditoria e o gerenciamento de configurações específicas do ambiente de forma programática, o que é especialmente útil para equipes que trabalham com instâncias de teste, desenvolvimento e produção.

Aqui está um exemplo simplificado de um snippet de resposta:

{
  "id": "your-environment-id",
  "name": "production",
  "image_optimization_type": "lossy",
  "is_opt_out_from_automatic_php_update": true
}

Para mais informações, veja a referência da API da Kinsta para ambientes.

Por que isso importa

Essas melhorias oferecem mais controle, especialmente para equipes que gerenciam múltiplos ambientes ou automatizam seus fluxos de trabalho.

  • Ajuste o desempenho de imagens sem acessar o Painel MyKinsta.

  • Gerencie o comportamento do Edge Caching diretamente via API — ideal para pipelines de CI/CD.

  • Garanta compatibilidade travando ambientes em versões específicas do PHP.

  • Audite configurações de ambientes em larga escala com os novos campos de resposta.

Tudo isso torna mais fácil construir com a Kinsta no seu ritmo, usando ferramentas e automações que já funcionam para sua equipe.

Veja todos os detalhes na documentação da API da Kinsta.