Tradicionalmente, nuestros servicios en Kinsta se han basado en interacciones manuales a través de MyKinsta, limitando el alcance únicamente a las interacciones humanas. Pero agárrate fuerte porque ¡todo está a punto de cambiar!

Presentamos la revolucionaria API de Kinsta (Application Programming Interface o Interfaz de Programación de Aplicaciones).

Di adiós a las limitaciones del pasado y disfruta de una era revolucionaria en la que las máquinas pueden interactuar perfectamente con nuestros servicios. Esto significa que ahora puedes realizar tareas en tu sitio Kinsta sin iniciar sesión en MyKinsta.

Qué es Posible con la API de Kinsta

Ahora puedes realizar tareas a distancia con una facilidad y eficacia inigualables. Estos son los casos de uso de la API de Kinsta:

1. Informes

Con la API de Kinsta, puedes integrar perfectamente los Servicios Kinsta en tus sistemas internos de seguimiento. Tanto si eres una agencia que busca listar todos los sitios, aplicaciones y bases de datos WordPress de tus clientes, como si eres un amante de los datos que busca crear paneles de control personalizados, nuestra API te permite recuperar datos analíticos de Kinsta sin esfuerzo.

2. Tareas Programadas

Se acabaron las tareas manuales nocturnas que afectan al rendimiento de tu sitio, porque con la API de Kinsta puedes crear aplicaciones para programar tareas, garantizando una interrupción mínima a tus visitantes. Ya sea limpiar la caché o ejecutar operaciones críticas, nuestra API te permite automatizar estas tareas sin esfuerzo.

3. Creación de Sitios WordPress

Utilizando la API de Kinsta, puedes crear un nuevo sitio/instalación de WordPress automáticamente. También puedes tomar el control de la funcionalidad de tu sitio instalando plugins populares, como WooCommerce y Yoast SEO, directamente desde la API.

¡Pero eso no es todo! Con la API de Kinsta, también puedes crear instalaciones WordPress Multisitio y configurar un subdominio (is_subdomain_multisite TRUE) o subdirectorio (is_subdomain_multisite FALSE).

Primeros Pasos Con la API Kinsta

Para empezar a utilizar la API de Kinsta, debes tener una cuenta activa en Kinsta con al menos un sitio de WordPress, aplicación o base de datos en MyKinsta. Además, necesitas generar una clave API para autenticarte y acceder a tu cuenta.

Autenticación y Acceso de Usuario

Para generar una clave API:

  1. Ve a tu panel de MyKinsta.
  2. Ve a la página API Keys (Tu nombre > Configuración de la empresa > API Keys).
  3. Haz clic en Crear API Key.
  4. Elige una fecha de caducidad o establece una fecha de inicio personalizada y un número de horas para que caduque la clave.
  5. Dale a la clave un nombre único.
  6. Haz clic en Generar.
Generar una API key
Crear API Key en MyKinsta.

Cuando se cree la API key, asegúrate de copiarla y guardarla en un lugar seguro, ya que es la única vez que podrás verla.

Puedes generar varias API keys, que se enumeran en la página API Keys. Si necesitas revocar una API key, haz clic en Revocar junto a la que quieras revocar.

Permisos

Implementar varios niveles de acceso para las API keys te ayuda a controlar el acceso a las API. En el caso de la API de Kinsta, el nivel de acceso a la API dependerá de los roles del usuario, ya que los propietarios de la empresa, los administradores y los desarrolladores pueden crear claves de API.

Por ejemplo, una API key generada por un desarrollador de una empresa no tendrá el mismo acceso que una clave generada por el propietario o administrador de una empresa.

Disfruta de la Automatización con la API de Kinsta

Una vez que tengas tu API key, puedes proceder a disfrutar de la automatización con la API de Kinsta. La documentación de referencia de la API de Kinsta proporciona una explicación detallada de cada endpoint, cómo consultarlos, los parámetros necesarios y las posibles respuestas, junto con ejemplos de solicitud y respuesta.

Por ejemplo, para obtener una lista de las aplicaciones de tu empresa, utiliza el endpoint applications. Este endpoint requiere el parámetro company con el valor del ID de tu empresa (puedes obtener esta información en tu página Detalles de Facturación en MyKinsta). Cuando envíes una solicitud GET al endpoint (https://api.kinsta.com/v2/applications?company=UNIQUE_COMPANY_ID), devolverá datos JSON que incluyen las aplicaciones de tu empresa:

{
    "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"
                },
            ]
        }
    }
}

Hay más cosas que puedes hacer con la API de Kinsta, como se documenta en la documentación de referencia de la API de Kinsta.

Comprobar el Estado de la Operación

Para las operaciones potencialmente de larga duración (por ejemplo, la creación de un sitio, limpieza de la caché, reinicio de PHP, etc.), la API no responde inmediatamente con el resultado. Esto ayuda a evitar un posible bloqueo del hilo del servidor o un tiempo de espera de la pasarela debido a que una operación tarda mucho tiempo.

Para comprobar el estado de una operación, utiliza el endpoint operations. Esto devolverá el estado de la operación. Por ejemplo

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

Este endpoint operations, requiere el operation_id como parámetro de ruta que obtendrás en una respuesta 202 Accepted cuando realices cualquier operación de larga duración. Para más detalles y ejemplos, consulta la referencia de operaciones.

Límite de Velocidad

Para evitar que nuestra API se vea inundada por demasiadas solicitudes, el número de solicitudes por minuto está limitado a 60. La excepción será la creación de sitios, que está limitada a 5 solicitudes por minuto.

Para ver el estado actual de tu límite de velocidad, comprueba las cabeceras RateLimit en tu respuesta API más reciente:

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

Actualmente, no es posible aumentar el límite de velocidad.

Solución de problemas

Si realizas una solicitud a un endpoint a la que tu API key no tiene acceso, la API responde con un mensaje de error para informarte de que no tienes acceso. Si necesitas acceder a ese endpoint, un propietario o administrador de la empresa puede generar una clave API para ti.

Libera el poder de la automatización y aumenta la eficiencia con la comodidad de la API de Kinsta. ¡Empieza hoy mismo!