Traditionnellement, nos services chez Kinsta s’appuient sur des interactions manuelles via MyKinsta, limitant ainsi le champ d’action aux seules interactions humaines. Mais tenez-vous bien car tout est sur le point de changer !

Nous introduisons l’API (interface de programmation d’applications) de Kinsta, qui change la donne.

Dites adieu aux limitations du passé et profitez d’une ère révolutionnaire où les machines peuvent interagir de manière transparente avec nos services. Cela signifie que vous pouvez désormais effectuer des tâches sur votre site Kinsta sans vous connecter à MyKinsta.

Ce qui est possible avec l’API Kinsta

Vous pouvez désormais effectuer des tâches à distance avec une facilité et une efficacité inégalées. Voici les cas d’utilisation de l’API Kinsta :

1. Rapports

Avec l’API de Kinsta, vous pouvez intégrer de manière transparente les services Kinsta dans vos systèmes de suivi internes. Que vous soyez une agence cherchant à répertorier tous les sites, applications et bases de données WordPress de vos clients, ou un passionné de données cherchant à construire des tableaux de bord personnalisés, notre API vous permet de récupérer les données analytiques de Kinsta sans effort.

2. Tâches planifiées

Finies les tâches manuelles nocturnes ayant un impact sur les performances de votre site, car avec l’API Kinsta, vous pouvez créer des applications pour planifier des tâches, garantissant ainsi une interruption minimale pour vos visiteurs. Qu’il s’agisse de vider le cache ou d’exécuter des opérations critiques, notre API vous permet d’automatiser ces tâches sans effort.

3. Création de sites WordPress

Grâce à l’API de Kinsta, vous pouvez créer automatiquemlent un nouveau site ou une nouvelle installation WordPress. Vous pouvez également prendre le contrôle de la fonctionnalité de votre site en installant des extensions populaires, telles que WooCommerce et Yoast SEO, directement à partir de l’API.

Mais ce n’est pas tout ! Avec l’API Kinsta, vous pouvez également créer des installations WordPress Multisite et configurer un sous-domaine (is_subdomain_multisite TRUE) ou un sous-répertoire (is_subdomain_multisite FALSE).

Démarrer avec l’API Kinsta

Pour commencer à utiliser l’API Kinsta, vous devez avoir un compte actif sur Kinsta avec au moins un site WordPress, une application ou une base de données dans MyKinsta. Vous devez également générer une clé API pour vous authentifier et accéder à votre compte.

Authentification et accès utilisateur

Pour générer une clé API :

  1. Allez sur votre tableau de bord MyKinsta.
  2. Naviguez jusqu’à la page des clés API (Votre nom > Réglages de l’entreprise > Clés API).
  3. Cliquez sur Créer une clé API.
  4. Choisissez une date d’expiration ou définissez une date de début personnalisée et un nombre d’heures pour l’expiration de la clé.
  5. Donnez un nom unique à la clé.
  6. Cliquez sur Générer.
Créez une clé API sur MyKinsta.
Créez une clé API sur MyKinsta.

Lorsque la clé API est créée, assurez-vous de la copier et de la conserver dans un endroit sûr, car c’est la seule fois où vous pourrez la voir.

Vous pouvez générer plusieurs clés d’API, qui sont répertoriées sur la page Clés d’API. Si vous devez révoquer une clé API, cliquez sur Révoquer en regard de celle que vous souhaitez révoquer.

Autorisations

La mise en œuvre de plusieurs niveaux d’accès pour les clés API vous aide à contrôler l’accès aux API. Pour l’API Kinsta, le niveau d’accès à l’API dépendra du rôle de l’utilisateur, car les propriétaires de l’entreprise, les administrateurs et les développeurs peuvent créer des clés API.

Par exemple, une clé API générée par un développeur d’entreprise n’aura pas le même accès qu’une clé générée par un propriétaire ou un administrateur d’entreprise.

Profitez de l’automatisation avec l’API Kinsta

Une fois que vous avez votre clé API, vous pouvez commencer à profiter de l’automatisation avec l’API Kinsta. La documentation de référence de l’API Kinsta fournit une explication détaillée de chaque point de terminaison, de la manière de les interroger, des paramètres nécessaires et des réponses possibles, ainsi que des exemples de demandes et de réponses.

Par exemple, pour obtenir une liste des applications de votre entreprise, utilisez le point de terminaison applications pour obtenir la liste des applications de votre entreprise. Ce point d’accès nécessite le paramètre company avec la valeur de l’ID de votre entreprise (vous pouvez obtenir cette information sur votre page de détails de facturation dans MyKinsta). Lorsque vous envoyez une requête GET au point d’accès (https://api.kinsta.com/v2/applications?company=UNIQUE_COMPANY_ID), celui-ci renvoie des données JSON comprenant les applications de votre entreprise :

{
    "company": {
        "apps": {
            "items": [
                {
                    "id": "ccd26ccb-8e78-4cf0-a5b2-2ab5d1a23760",
                    "name": "chatgpt-clone-g9q10",
                    "display_name": "chatgpt-clone",
                    "status": "deploymentSuccess"
                },
                {
                    "id": "1adf1e9c-f35e-491e-bec9-fe00ad9f2086",
                    "name": "kinsta-developer-portfolio-ir8w8",
                    "display_name": "Kinsta-developer-portfolio",
                    "status": "deploymentSuccess"
                },
            ]
        }
    }
}

Les possibilités de l’API Kinsta sont encore plus nombreuses, comme indiqué dans la documentation de référence de l’API Kinsta.

Vérifier l’état de l’opération

Pour les opérations qui peuvent durer longtemps (par exemple, la création d’un site, l’effacement du cache, le redémarrage de PHP, etc.), l’API ne répond pas immédiatement avec le résultat. Cela permet d’éviter un éventuel blocage du thread du serveur ou un dépassement du temps de la passerelle en raison d’une opération qui prend beaucoup de temps.

Pour vérifier le statut d’une opération, utilisez le point de terminaison operations. Celui-ci renverra le statut de l’opération. Par exemple :

{
  "status": 202,
  "message": "Operation in progress",
  "data": null
}

Ce point de terminaison operations, nécessite le paramètre operation_id comme chemin d’accès, que vous obtiendrez dans une réponse 202 Accepted lorsque vous effectuerez une opération de longue durée. Pour plus de détails et d’exemples, consultez la référence des opérations.

Limite de débit

Pour éviter que notre API ne soit submergée par un trop grand nombre de requêtes, le nombre de requêtes par minute est limité à 60. L’exception concerne la création de sites, qui est limitée à 5 requêtes par minute.

Pour connaître l’état actuel de votre limite de débit, vérifiez les en-têtes RateLimit dans votre dernière réponse à l’API :

RateLimit-Limit: 60
RateLimit-Remaining: 50
RateLimit-Reset: 60

Actuellement, il n’est pas possible d’augmenter la limite de débit.

Résolution des problèmes

Si vous faites une requête à un point de terminaison auquel votre clé API n’a pas accès, l’API répond par un message d’erreur pour vous indiquer que vous n’y avez pas accès. Si vous avez besoin d’accéder à ce point de terminaison, un propriétaire ou un administrateur de l’entreprise peut générer une clé API pour vous.

Libérez la puissance de l’automatisation et augmentez l’efficacité grâce à la commodité de l’API Kinsta. Commencez dès aujourd’hui !