Travailler avec des environnements vient de devenir plus facile. Cette mise à jour de l’API Kinsta introduit de nouvelles façons de récupérer des données sur la structure des fichiers, d’effectuer des poussées sélectives de fichiers entre les environnements et de récupérer tous les environnements en une seule demande lors de l’établissement de la liste des sites.

Ces ajouts sont conçus pour réduire le nombre d’appels que vous devez effectuer, afin que vos déploiements et vos outils de développement soient plus rapides et plus efficaces.

Obtenir la liste des fichiers d’un environnement

Vous pouvez maintenant récupérer la structure complète des répertoires d’un environnement WordPress en utilisant l’API Kinsta. Ce nouveau point de terminaison renvoie une liste récursive de dossiers et de sous-dossiers, vous donnant une vue claire de ce qui se trouve à l’intérieur de chaque environnement – aucune connexion SSH n’est nécessaire.

Ceci est particulièrement utile pour construire des outils internes, valider les chemins de fichiers avant des déploiements sélectifs, ou automatiser des tâches d’environnement avec précision.

Vous pouvez envoyer une requêteGET :

GET /sites/environments/{env_id}/file-list

Voici un exemple de requête utilisant curl :

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/file-list' \
  -H 'Authorization: Bearer '

La réponse comprend des objets imbriqués représentant des répertoires comme :

  • wp-content/
  • wp-content/plugins/
  • wp-content/themes/
  • wp-content/uploads/

Chaque dossier contient son nom, son chemin d’accès et ses éventuels enfants, ce qui permet de le cartographier ou de le visualiser facilement.

Poussée sélective de fichiers entre environnements

Le point d’accès Push Environment existant permet désormais de gérer les transferts de fichiers de manière plus souple. Grâce à deux nouveaux champs optionnels, vous pouvez transférer l’environnement complet ou cibler des répertoires spécifiques, ce qui est parfait pour les flux de travail dans lesquels vous ne souhaitez pas tout synchroniser.

Vous pouvez envoyer une requêtePUT :

PUT /sites/{site_id}/environments

Utilisez les champs suivants pour contrôler les fichiers à inclure :

  • push_files_option : Choisissez entre « ALL_FILES » ou « SPECIFIC_FILES »
  • file_list : Fournissez une liste des chemins d’accès aux répertoires que vous souhaitez pousser

Voici un exemple utilisant curl pour pousser uniquement les dossiers sélectionnés d’un environnement vers un autre :

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/{site_id}/environments' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_env_id": "your-source-env-id",
    "target_env_id": "your-target-env-id",
    "push_db": true,
    "push_files": true,
    "run_search_and_replace": true,
    "push_files_option": "SPECIFIC_FILES",
    "file_list": [
      "wp-content/plugins",
      "wp-content/themes",
      "wp-content/uploads"
    ]
  }'

Cette approche sélective est utile :

  • Réduire le temps de déploiement en synchronisant uniquement ce qui a été modifié
  • Éviter d’écraser d’autres ressources ou téléversements
  • Améliorer le contrôle lors du transfert des modifications de la phase de staging à la phase de production

Si vous n’incluez pas push_files_option, il s’agit par défaut de "ALL_FILES", ce qui maintient la compatibilité ascendante.

Liste des sites et de leurs environnements en un seul appel

Vous pouvez désormais récupérer tous les sites d’une entreprise et leurs environnements à l’aide d’un seul appel à l’API. En ajoutant le paramètre de requête include_environments=true au point de terminaison GET /sites, la réponse inclut les environnements associés à chaque site, sans qu’il soit nécessaire d’effectuer des requêtes de suivi distinctes.

Cette fonctionnalité est particulièrement utile pour les agences ou les équipes gérant un grand nombre de sites, où la minimisation des appels à l’API et l’accélération des audits d’environnement peuvent faire une grande différence.

GET /sites?company=your-company-id&include_environments=true

Voici un exemple de requête curl :

curl -i -X GET \
'https://api.kinsta.com/v2/sites?company=your-company-id&include_environments=true' \
  -H 'Authorization: Bearer '

La réponse comprend les métadonnées du site (nom, ID, etc.) et une liste imbriquée d’environnements (staging, production, etc.).

API Kinsta : Conçue pour les équipes qui gèrent à grande échelle

Ces améliorations de l’API sont conçues pour gagner du temps et réduire la complexité, en particulier pour les développeurs et les agences qui gèrent des dizaines (ou des centaines) de sites WordPress.

Que vous synchronisiez des fichiers d’extensions sélectionnés, construisiez des outils internes ou augmentiez des environnements à travers un portfolio, ces améliorations aident à rationaliser le travail que vous auriez dû faire manuellement dans le tableau de bord.

Vous pouvez explorer ces nouvelles capacités dans la documentation de l’API Kinsta ou sauter directement dans MyKinsta pour générer votre jeton d’accès et commencer à construire.