L’API de Kinsta vient de recevoir une nouvelle série de mises à jour qui permettent aux développeurs et aux gestionnaires de sites de mieux contrôler les performances de leurs sites en amont et en aval.

Que vous développiez des scripts d’automatisation ou que vous construisiez des outils personnalisés pour votre environnement, ces ajouts facilitent la gestion précise du comportement du CDN, des réglages de cache et des mises à jour de la version PHP.

Contrôle de l’optimisation des images

Vous pouvez désormais gérer les réglages d’optimisation des images pour n’importe quel environnement à l’aide de l’API Kinsta. Ce nouveau point de terminaison donne aux développeurs la flexibilité d’ajuster la façon dont Kinsta compresse et sert les images sans avoir besoin de se connecter à MyKinsta.

Ceci est particulièrement utile si vous automatisez des déploiements ou si vous gérez plusieurs environnements à grande échelle. En fonction de votre cas d’utilisation, vous pouvez choisir l’un des modes d’optimisation suivants :

  • off – Désactive complètement l’optimisation des images.
  • lossy – Applique une compression agressive pour réduire la taille des fichiers et accélérer les temps de chargement, au prix d’une certaine fidélité visuelle.
  • lossless – Compresse les images sans en réduire la qualité, en préservant la netteté tout en réduisant la taille du fichier.

Pour mettre à jour les réglages d’optimisation de l’image pour un environnement, envoyez une requête PUT:

PUT /sites/cdn/image-optimization

Le corps de votre requête doit inclure le environment_id et le type d’optimisation souhaité. Voici un exemple rapide utilisant curl pour appliquer une optimisation avec perte :

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

Cette mise à jour vous permet de mieux contrôler la manière dont les ressources multimédias sont diffusées, ce qui est idéal pour adapter les performances dans les environnements de production, de staging à forte densité de médias.

Pour plus d’informations sur le fonctionnement de l’optimisation des images chez Kinsta, consultez notre documentation CDN.

Activer ou désactiver la mise en cache Edge

Vous pouvez désormais activer ou désactiver la mise en cache pour un environnement spécifique en utilisant l’API de Kinsta. Ce nouveau point de terminaison vous permet d’activer ou de désactiver par programmation la mise en cache Edge, ce qui vous donne un meilleur contrôle sur la façon dont le contenu est servi à travers le CDN mondial de Kinsta.

Ceci est particulièrement utile lors des déploiements, des tests ou des scénarios de dépannage où vous avez besoin de contourner temporairement ou de rétablir le contenu mis en cache.

Vous pouvez envoyer une requête PUT:

PUT /sites/edge-caching/status

Incluez le champ environment_id et un champ booléen enabled dans le corps de la requête. Voici un exemple de requête utilisant curl pour activer la mise en cache Edge :

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

Le fait de remplacer enabled par false désactive la mise en cache pour cet environnement. Cette option est utile si vous diffusez activement des mises à jour et que vous souhaitez éviter les retards de mise en cache.

Désactiver les mises à jour automatiques de PHP

Nous avons ajouté un nouveau niveau de contrôle à l’API Kinsta pour la gestion des versions PHP. Lorsque vous modifiez la version PHP d’un environnement, vous pouvez maintenant inclure le drapeau optionnel is_opt_out_from_automatic_php_update pour refuser les futures mises à jour automatiques.

Cette mise à jour est particulièrement utile pour les équipes qui ont besoin de maintenir la cohérence des versions entre les environnements ou de retarder les mises à jour pour assurer la compatibilité avec le code personnalisé, les extensions ou les dépendances héritées.

Envoyez une requête PUT:

PUT /sites/tools/modify-php-version

Le corps de la requête doit inclure l’identifiant de votre environnement, la version PHP cible et le nouveau drapeau is_opt_out_from_automatic_php_update à true ou false. Voici un exemple de requête 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
  }'

En définissant ce drapeau sur true, votre environnement reste sur la version PHP sélectionnée à moins que vous ne le mettiez à jour manuellement via l’API ou dans le tableau de bord MyKinsta. Si l’indicateur est omis ou défini sur false, l’environnement suit le calendrier de mise à jour automatique par défaut de Kinsta pour les versions PHP prises en charge.

Pour plus d’informations, vous pouvez consulter notre documentation sur la gestion de PHP.

Nouveaux champs dans les réponses de l’environnement

Le point de terminaison GET /sites/{site_id}/environments renvoie désormais deux champs supplémentaires qui offrent une meilleure visibilité sur la façon dont chaque environnement est configuré :

  • image_optimization_type – Affiche le paramètre d’optimisation d’image actuel appliqué via le CDN. Il peut s’agir de « off », « lossy », ou « lossless" », ce qui vous permet de confirmer les niveaux d’optimisation dans les différents environnements en un coup d’œil.
  • is_opt_out_from_automatic_php_update – Indique si les mises à jour PHP automatiques sont désactivées pour l’environnement. S’il est défini sur true, l’environnement ne recevra pas les mises à jour PHP programmées.

Cette amélioration facilite l’audit et la gestion programmatique des paramètres spécifiques à l’environnement, ce qui est particulièrement utile pour les équipes travaillant sur des instances de staging, de développement et de production.

Voici un exemple simplifié d’extrait de réponse :

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

Pour en savoir plus, consultez notre référence API pour les points de terminaison d’environnement.

En quoi cela est-il important ?

Ces mises à jour ont pour but de vous donner plus de contrôle, en particulier si vous gérez plusieurs environnements ou si vous automatisez votre flux de travail.

  • Affinez les performances des images sans vous connecter au tableau de bord.
  • Gérez le comportement du cache Edge directement via l’API, ce qui est idéal pour les pipelines de déploiement.
  • Assurez la compatibilité des versions de PHP en verrouillant les environnements à une version spécifique lorsque cela est nécessaire.
  • Auditez les réglages de l’environnement à l’échelle grâce à de nouveaux champs de réponse.

Ensemble, ces changements facilitent la construction avec Kinsta selon vos conditions en utilisant les outils et les automatisations qui fonctionnent déjà pour votre équipe.

Vous trouverez tous les détails des requêtes et des réponses dans la documentation de l’API Kinsta.