Breve introducci\u00f3n a la API de Kinsta<\/h2>\n
En pocas palabras, la API Kinsta<\/a> te permite interactuar mediante programaci\u00f3n con tus sitios y entornos en nuestra plataforma. Te proporcionamos un conjunto de endpoints que puedes utilizar para realizar diversas tareas, como crear nuevos sitios de WordPress, clonar sitios existentes, gestionar copias de seguridad, etc.<\/p>\n Esta API RESTful<\/a> ofrece muchas ventajas a tus proyectos de desarrollo gracias a sus caracter\u00edsticas y funcionalidades clave:<\/p>\n Si quieres saber m\u00e1s sobre lo que est\u00e1 disponible en la API de Kinsta, consulta la documentaci\u00f3n dedicada<\/a>. Aun as\u00ed, veremos muchos ejemplos en el resto del post tras una inmersi\u00f3n m\u00e1s profunda en los beneficios que puede proporcionarte la API.<\/p>\n Por supuesto, nos encanta el panel de MyKinsta<\/a> por su profundidad, su magn\u00edfica interfaz y su nivel de control. Sin embargo, tambi\u00e9n puedes encontrar la mayor parte de la funcionalidad dentro de la API de Kinsta. Si eres desarrollador, esto deber\u00eda ser emocionante por varias razones:<\/p>\n Pero basta de charla: pasemos a utilizar la API Kinsta. Aunque la API de Kinsta ofrece muchos endpoints, te sentir\u00e1s m\u00e1s atra\u00eddo por unos que por otros. A la hora de desarrollar, utilizar\u00e1s algunos de ellos una y otra vez.<\/p>\n Estos endpoints cubren la funcionalidad b\u00e1sica que necesitar\u00e1s para la mayor\u00eda de los flujos de trabajo de desarrollo. Sin embargo, hay otros que pueden complementar los endpoints que utilizas a menudo. Por ejemplo, los que gestionan las bases de datos, el despliegue, el almacenamiento en cach\u00e9 y tu Red de Entrega de Contenidos (CDN, Content Delivery Network) desempe\u00f1an un papel importante.<\/p>\n Durante el resto del art\u00edculo, veremos c\u00f3mo utilizar la API de Kinsta para el desarrollo en el mundo real. En la secci\u00f3n de comentarios, al final del art\u00edculo, puedes incluso compartir tus propios ejemplos de c\u00f3mo crees que la API de Kinsta podr\u00eda ser \u00fatil \u2014 \u00a1nos encantar\u00eda escucharlos!<\/p>\n Intentemos ilustrar c\u00f3mo puedes utilizar la API de Kinsta en la pr\u00e1ctica. Hay muchas formas de desarrollar en WordPress, as\u00ed que veremos c\u00f3mo una agencia de dise\u00f1o web podr\u00eda utilizar la API a lo largo de un flujo de trabajo. En general, esto implicar\u00e1 unos cuantos pasos:<\/p>\n A pesar de lo mucho que aparecer\u00e1 la API de Kinsta en este post, nuestro primer paso no la necesitar\u00e1. Empecemos por configurar tu entorno de desarrollo local, y luego pasemos a los elementos program\u00e1ticos para staging y producci\u00f3n.<\/p>\n Tu entorno local tiene que ser s\u00f3lido como una roca, y cada desarrollador tiene su propio enfoque favorito<\/a>. Por supuesto, en este caso nuestra elecci\u00f3n ser\u00e1 DevKinsta<\/a>.<\/p>\n Esto puede simplificar el proceso de configuraci\u00f3n de tu entorno local, especialmente si utilizas el alojamiento de Kinsta. DevKinsta es gratuito y te ofrece un mont\u00f3n de funcionalidades que otras herramientas similares no pueden ofrecerte:<\/p>\n DevKinsta tambi\u00e9n proporciona una serie de herramientas a nivel de desarrollador. Por ejemplo, puedes activar Xdebug<\/a> con un clic y editar los archivos de configuraci\u00f3n php.ini<\/strong> y Nginx desde la pantalla de configuraci\u00f3n:<\/p>\n Configurar y utilizar DevKinsta est\u00e1 fuera del alcance de este post, ya que queremos centrarnos en la API de Kinsta. Sin embargo, tenemos documentaci\u00f3n completa<\/a> sobre c\u00f3mo empezar con el entorno local que deber\u00eda ser de lectura obligatoria.<\/p>\n Llegados a este punto, tendr\u00e1s un entorno de desarrollo local (\u00a1ojal\u00e1 DevKinsta!) y un sitio lo suficientemente completo como para pasar al siguiente paso. La creaci\u00f3n de un entorno staging utiliza tanto la funcionalidad de DevKinsta como la de la API de Kinsta. Vamos a dividirlo en unos breves pasos.<\/p>\n En primer lugar, busca crear un nuevo entorno staging<\/a> con la API de Kinsta. Esto es algo que puedes hacer dentro de DevKinsta a trav\u00e9s de los enlaces al panel MyKinsta:<\/p>\n Sin embargo, la API de Kinsta tiene endpoints<\/a> para abarcar todos los casos pr\u00e1cticos de uso. Por ejemplo, puedes crear sitios y entornos tanto vac\u00edos como con datos. En este punto, te recomendamos que utilices entornos vac\u00edos, ya que puedes tener la tranquilidad de que tu sitio local se trasladar\u00e1 a una ubicaci\u00f3n \u00ablimpia\u00bb.<\/p>\n Para ello, primero tendr\u00e1s que configurar un nuevo sitio de WordPress<\/a> en Kinsta utilizando el endpoint adecuado:<\/p>\n Una vez creado el sitio, puedes obtener una lista de sitios<\/a> pasando un ID de empresa:<\/p>\n Una vez hecho esto, puedes crear el entorno staging<\/a> utilizando el ID de sitio correcto:<\/p>\n Tambi\u00e9n te recomendamos que crees una base de datos para el sitio staging mientras est\u00e1s aqu\u00ed. En unos momentos, la sobrescribir\u00e1s con tu base de datos local, pero inicializar un marcador de posici\u00f3n es una buena pr\u00e1ctica:<\/p>\n Dependiendo de tu configuraci\u00f3n, puede que tambi\u00e9n necesites a\u00f1adir un nuevo dominio<\/a> a Kinsta, lo que puedes hacer a trav\u00e9s de un simple endpoint. Sin embargo, una vez que el staging est\u00e9 configurado, puedes intentar enviar tus cambios locales a \u00e9l.<\/p>\n El proceso exacto para enviar tus cambios al staging depender\u00e1 de tu configuraci\u00f3n y herramientas espec\u00edficas. Un enfoque general y t\u00edpico puede ser el siguiente:<\/p>\n Aqu\u00ed no vamos a hablar del control de versiones<\/a>, pero DevKinsta ofrece herramientas \u00fatiles para ayudarte a subir cambios a tu alojamiento Kinsta:<\/p>\n Esto te permitir\u00e1 elegir el entorno de todo tu servidor de alojamiento. Una vez hecho esto, tambi\u00e9n puedes elegir enviar tu base de datos \u2014 de nuevo, algo que no muchas herramientas de desarrollo local te permiten hacer:<\/p>\n Una vez que hayas poblado tu entorno staging en Kinsta, la API te resultar\u00e1 muy \u00fatil. Por ejemplo, puedes crear un script y ejecutar una copia de seguridad inicial, que s\u00f3lo necesita un ID de entorno y una etiqueta:<\/p>\n Tambi\u00e9n puedes instalar otros temas y plugins<\/a> en esta fase, si lo deseas. Llegados a este punto, terminar\u00e1 nuestro uso de DevKinsta, ya que a partir de ahora podr\u00e1s desplegar tu sitio utilizando la API de Kinsta.<\/p>\n Antes de enviar los cambios a producci\u00f3n<\/a>, deber\u00e1s realizar algunas tareas cruciales, todas ellas con la API de Kinsta:<\/p>\n A partir de aqu\u00ed, debes probar completamente tu sitio<\/a> en el entorno staging y obtener la aprobaci\u00f3n de tu cliente. Llegados a este punto, ya puedes desplegarlo. Kinsta te ofrece un par de opciones para ello:<\/p>\n Nos centraremos (por supuesto) en la segunda opci\u00f3n, ya que permite un flujo de trabajo m\u00e1s automatizado y racionalizado.<\/p>\n La API de Kinsta ofrece varias formas de mover un entorno. Puedes enviar tu entorno staging<\/a> al de producci\u00f3n o clonarlo<\/a>.<\/p>\n En cualquier caso, es una buena idea crear otra copia de seguridad de cada entorno que est\u00e9s ejecutando para que puedas recuperarte si algo va mal.<\/p>\n La API de Kinsta es una potente forma de realizar cambios program\u00e1ticos en tus sitios y entornos. Como tal, debes tener cuidado al utilizarla, ya que si algo va mal, ser\u00e1 tu responsabilidad repararlo.<\/p>\n Teniendo esto en cuenta, repasemos algunos consejos, trucos y pr\u00e1cticas habituales que deber\u00edas integrar en tu propio flujo de trabajo de desarrollo:<\/p>\n Esto es mucho m\u00e1s importante cuando se trata de colaborar con equipos y de cualquier automatizaci\u00f3n que quieras emplear. Nuestra secci\u00f3n final examina esto con un poco m\u00e1s de detalle.<\/p>\n Una de las mayores ventajas de utilizar la API de Kinsta es la posibilidad de automatizar tareas repetitivas en tu flujo de trabajo de desarrollo. Escribiendo scripts o integr\u00e1ndote con otras herramientas, puedes agilizar los procesos y ahorrar tiempo.<\/p>\n Para agilizar por completo tu flujo de trabajo, puedes automatizar el paso de staging a producci\u00f3n integrando la API de Kinsta con tu canal de CI\/CD. Esto puede ser un proceso complejo y subjetivo que incluso puede cambiar de un proyecto a otro. Por ejemplo, aqu\u00ed tienes un ejemplo de flujo de trabajo para un script adecuado:<\/p>\n Este es el gran punto a favor de la API Kinsta. Puedes automatizar casi todos los aspectos de tu flujo de trabajo para garantizar despliegues coherentes y fiables. Tambi\u00e9n puedes hacer mucho m\u00e1s con esto:<\/p>\n Lo mejor de la API de Kinsta es todo lo que puedes controlar utilizando m\u00e9todos program\u00e1ticos. El alcance aqu\u00ed es amplio, e incluso podr\u00edas crear paneles personalizados<\/a> que muestren algunas de estas m\u00e9tricas u opciones para un flujo de trabajo de desarrollo a\u00fan m\u00e1s fluido.<\/p>\n\n
Por qu\u00e9 tus flujos de trabajo de desarrollo pueden beneficiarse de la API Kinsta<\/h2>\n
![\"El](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/mykinsta-dashboard-1.png\")
\n
\nEmpezaremos con los endpoints que mejor funcionan para el desarrollo y luego los utilizaremos dentro de tu flujo de trabajo.<\/p>\nEndpoints de la API de Kinsta para el desarrollo<\/h2>\n
\n
Un caso de uso en el mundo real: desplegar un sitio a trav\u00e9s de programaci\u00f3n<\/h2>\n
\n
1. Configurar un entorno de desarrollo local<\/h3>\n
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/devkinsta-splash.png\")
\n
![\"El](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/nginx-config.png\")
2. Gesti\u00f3n de los entornos de desarrollo local y staging<\/h3>\n
Crear un entorno staging<\/h4>\n
![\"Cuadro](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/create-environment.png\")
const resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/sites\/plain`,\n {\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n company: '54fb80af-576c-4fdc-ba4f-b596c83f15a1',\n display_name: 'First plain site',\n region: 'us-central1'\n })\n }\n);\n\nconst data = await resp.json();\n<\/code><\/pre>\n\u2026\n \"company\": {\n \"sites\": [\n {\n \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n \"name\": \"firstsite\",\n \"display_name\": \"First site\",\n \"status\": \"live\",\n \"siteLabels\": [\n {\n \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n \"name\": \"Do not remove\"\n\u2026\n<\/code><\/pre>\nconst siteId = 'YOUR_site_id_PARAMETER';\nconst resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/sites\/${siteId}\/environments\/plain`,\n {\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n display_name: 'staging',\n is_premium: false\n })\n }\n);\n\nconst data = await resp.json();\n<\/code><\/pre>\n\u2026\n {\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n company_id: '54fb80af-576c-4fdc-ba4f-b596c83f15a1',\n location: 'us-central1',\n resource_type: 'db1',\n display_name: 'test-db',\n db_name: 'test-db',\n db_password: 'example-password',\n db_user: 'example-user',\n type: 'postgresql',\n version: '15'\n })\n }\n);\n\u2026\n<\/code><\/pre>\nSincronizar cambios de local a staging<\/h4>\n
\n
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/push-to-kinsta.png\")
![\"El](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/devkinsta-database.png\")
{\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n tag: 'my-awesome-backup'\n })\n }\n);\n<\/code><\/pre>\n3. Enviar los cambios de staging a producci\u00f3n<\/h3>\n
\n
\n
Utilizar la API para desplegar cambios<\/h4>\n
const siteId = 'YOUR_site_id_PARAMETER';\nconst resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/sites\/${siteId}\/environments`,\n {\n method: 'PUT',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n source_env_id: '54fb80af-576c-4fdc-ba4f-b596c83f15a1',\n target_env_id: '54fb80af-576c-4fdc-ba4f-b596c83f15a1',\n push_db: true,\n push_files: true,\n run_search_and_replace: true\n })\n }\n);\n\nconst data = await resp.json();\n<\/code><\/pre>\nPr\u00e1cticas habituales y consejos para utilizar la API de Kinsta<\/h2>\n
\n
Automatizar tu flujo de trabajo de desarrollo<\/h2>\n
\n
\n
Resumen<\/h2>\n