Uma breve introdu\u00e7\u00e3o sobre a API da Kinsta<\/h2>\n
Em resumo, a API da Kinsta<\/a> permite que voc\u00ea interaja de forma program\u00e1tica com seus sites e ambientes em nossa plataforma. Fornecemos um conjunto de endpoints que voc\u00ea pode usar para realizar v\u00e1rias tarefas, como criar novos sites WordPress, clonar sites existentes, gerenciar backups e muito mais.<\/p>\n Essa API RESTful<\/a> oferece muitos benef\u00edcios aos seus projetos de desenvolvimento, gra\u00e7as aos seus principais recursos e funcionalidades:<\/p>\n Se voc\u00ea quiser saber mais sobre o que est\u00e1 dispon\u00edvel na API da Kinsta, consulte a documenta\u00e7\u00e3o dedicada<\/a>. Mesmo assim, veremos v\u00e1rios exemplos no restante do artigo ap\u00f3s um mergulho mais profundo nos benef\u00edcios que a API pode lhe oferecer.<\/p>\n Naturalmente, adoramos o painel MyKinsta<\/a>, por sua profundidade, interface atraente e n\u00edvel de controle. No entanto, voc\u00ea tamb\u00e9m pode encontrar a maior parte da funcionalidade na API da Kinsta. Se voc\u00ea \u00e9 um desenvolvedor, isso \u00e9 interessante por diferentes motivos:<\/p>\n Mas chega de conversa: vamos tratar logo de usar a API da Kinsta. Come\u00e7aremos com os endpoints que funcionam bem para o desenvolvimento e depois os usaremos em seu fluxo de trabalho.<\/p>\n Embora a API da Kinsta ofere\u00e7a muitos endpoints, voc\u00ea ir\u00e1 gostar mais de uns do que de outros. No desenvolvimento, voc\u00ea usar\u00e1 alguns deles com mais frequ\u00eancia:<\/p>\n Esses endpoints abrangem a funcionalidade principal de que voc\u00ea precisar\u00e1 para a maioria dos fluxos de trabalho de desenvolvimento. No entanto, h\u00e1 outros que podem complementar os endpoints que voc\u00ea usa com frequ\u00eancia. Por exemplo, os que lidam com bancos de dados, implanta\u00e7\u00e3o, armazenamento em cache e sua rede de distribui\u00e7\u00e3o de conte\u00fado (CDN) t\u00eam todos uma fun\u00e7\u00e3o a desempenhar.<\/p>\n No restante do artigo, mostraremos como voc\u00ea pode usar a API da Kinsta para desenvolvimento no mundo real. Na se\u00e7\u00e3o de coment\u00e1rios no final do artigo, voc\u00ea pode at\u00e9 mesmo compartilhar seus pr\u00f3prios exemplos de onde acha que a API da Kinsta pode ser \u00fatil \u2013 adoraremos ouvir!<\/p>\n Vamos tentar ilustrar como voc\u00ea pode usar a API da Kinsta na pr\u00e1tica. H\u00e1 muitas maneiras de desenvolver o WordPress; assim, veremos como uma ag\u00eancia de web design pode usar a API em um fluxo de trabalho. Em geral, isso envolver\u00e1 algumas etapas:<\/p>\n Apesar de a API da Kinsta estar presente ao longo de todo este artigo, nossa primeira etapa n\u00e3o precisar\u00e1 dela. Vamos come\u00e7ar configurando seu ambiente de desenvolvimento local e, em seguida, passar para os elementos program\u00e1ticos de teste e produ\u00e7\u00e3o.<\/p>\n Seu ambiente local precisa ser s\u00f3lido como uma rocha, e cada desenvolvedor ter\u00e1 sua pr\u00f3pria abordagem favorita<\/a>. Obviamente, nossa escolha aqui ser\u00e1 o DevKinsta<\/a>.<\/p>\n Isso pode simplificar o processo de configura\u00e7\u00e3o do seu ambiente local, especialmente se voc\u00ea usar a hospedagem da Kinsta. O DevKinsta \u00e9 gratuito e oferece muitas funcionalidades que outras ferramentas semelhantes n\u00e3o t\u00eam:<\/p>\n O DevKinsta tamb\u00e9m fornece v\u00e1rias ferramentas de n\u00edvel de desenvolvedor. Por exemplo, voc\u00ea pode ativar o Xdebug<\/a> com um clique e editar os arquivos de configura\u00e7\u00e3o php.ini<\/strong> e Nginx na tela de configura\u00e7\u00f5es:<\/p>\n A configura\u00e7\u00e3o e o uso do DevKinsta est\u00e3o al\u00e9m do escopo deste artigo, pois queremos nos concentrar na API da Kinsta. No entanto, temos uma documenta\u00e7\u00e3o completa<\/a> sobre como come\u00e7ar com o ambiente local que deveria ser leitura obrigat\u00f3ria.<\/p>\n Neste ponto, voc\u00ea ter\u00e1 um ambiente de desenvolvimento local (esperamos que seja o DevKinsta!) e um site completo o suficiente para passar para a pr\u00f3xima etapa. Ao criar um ambiente de teste, voc\u00ea usa tanto a funcionalidade do DevKinsta quanto da API da Kinsta. Vamos dividir isso em algumas etapas curtas.<\/p>\n Primeiro, voc\u00ea deve criar um novo ambiente de teste<\/a> com a API da Kinsta. Isso \u00e9 algo que voc\u00ea pode fazer no DevKinsta por meio de links para o painel MyKinsta:<\/p>\n Todavia, a API da Kinsta tem endpoints<\/a> para cobrir todos os casos de uso pr\u00e1tico. Por exemplo, voc\u00ea pode criar sites e ambientes simples ou populosos. Recomendamos usar ambientes simples neste momento, para ter a tranquilidade de saber que seu site local ser\u00e1 movido para um local “novo”.<\/p>\n Isso exigir\u00e1 que voc\u00ea primeiro configure um novo site WordPress<\/a> na Kinsta usando o endpoint apropriado:<\/p>\n Quando o site estiver instalado, voc\u00ea poder\u00e1 obter uma lista de sites<\/a> passando um ID de empresa:<\/p>\n Ap\u00f3s concluir isso, voc\u00ea poder\u00e1 criar o ambiente de teste <\/a>usando o ID do site correto:<\/p>\n Tamb\u00e9m recomendamos que voc\u00ea crie um banco de dados para o site de teste enquanto estiver aqui. Em alguns instantes, voc\u00ea o substituir\u00e1 pelo banco de dados local, mas inicializar um espa\u00e7o reservado \u00e9 uma boa pr\u00e1tica:<\/p>\n Dependendo da sua configura\u00e7\u00e3o, talvez voc\u00ea tamb\u00e9m precise adicionar um novo dom\u00ednio<\/a> \u00e0 Kinsta, o que pode ser feito por meio de um endpoint simples. No entanto, depois que o ambiente de teste estiver configurado, voc\u00ea pode tentar enviar suas altera\u00e7\u00f5es locais para l\u00e1.<\/p>\n O processo exato para enviar suas altera\u00e7\u00f5es para o ambiente de teste depender\u00e1 da sua configura\u00e7\u00e3o e ferramentas espec\u00edficas. Uma t\u00edpica abordagem geral pode se parecer com a seguinte:<\/p>\n N\u00e3o abordaremos o controle de vers\u00e3o<\/a> aqui, mas o DevKinsta oferece ferramentas \u00fateis para enviar as altera\u00e7\u00f5es para a sua hospedagem Kinsta:<\/p>\n Isso permitir\u00e1 escolher o ambiente de todo o seu servidor de hospedagem. Depois de fazer isso, voc\u00ea tamb\u00e9m pode optar por enviar seu banco de dados \u2013 novamente, algo que n\u00e3o \u00e9 permitido por muitas ferramentas de desenvolvimento local:<\/p>\n Depois que voc\u00ea preencher seu ambiente de teste da Kinsta, a API ser\u00e1 \u00fatil. Por exemplo, voc\u00ea pode criar um script e executar um backup inicial, que s\u00f3 precisa de um ID de ambiente e uma tag:<\/p>\n Voc\u00ea tamb\u00e9m pode instalar outros temas e plugins<\/a> nesse est\u00e1gio, se desejar. Neste ponto, nosso uso do DevKinsta terminar\u00e1, porque voc\u00ea pode implantar seu site usando a API da Kinsta daqui pra frente.<\/p>\n Antes de enviar as altera\u00e7\u00f5es para a produ\u00e7\u00e3o<\/a>, voc\u00ea dever\u00e1 realizar algumas tarefas cruciais, todas com a API da Kinsta:<\/p>\n A partir daqui, voc\u00ea deve testar totalmente o seu site<\/a> no ambiente de teste e obter a aprova\u00e7\u00e3o do cliente. Nesse ponto, voc\u00ea pode procurar fazer a implanta\u00e7\u00e3o. A Kinsta oferece a voc\u00ea algumas op\u00e7\u00f5es para isso:<\/p>\n Vamos (obviamente) nos concentrar na segunda op\u00e7\u00e3o, pois permite que voc\u00ea tenha um fluxo de trabalho mais automatizado e simplificado.<\/p>\n A API da Kinsta oferece v\u00e1rias maneiras de mover um ambiente. Voc\u00ea pode enviar seu ambiente de teste<\/a> para o de produ\u00e7\u00e3o ou clon\u00e1-lo<\/a>.<\/p>\n Independentemente disso, \u00e9 uma boa ideia criar outro backup de cada ambiente que voc\u00ea est\u00e1 executando para ser recuperado se algo der errado.<\/p>\n A API da Kinsta \u00e9 uma maneira poderosa de realizar altera\u00e7\u00f5es program\u00e1ticas em seus sites e ambientes. Por isso, voc\u00ea precisa tomar cuidado ao us\u00e1-la, pois se algo der errado, ser\u00e1 sua responsabilidade corrigir isso.<\/p>\n Com isso em mente, vamos examinar algumas dicas, truques e pr\u00e1ticas t\u00edpicas que voc\u00ea deve integrar ao seu pr\u00f3prio fluxo de trabalho de desenvolvimento:<\/p>\n Isso \u00e9 muito mais importante quando se trata de colabora\u00e7\u00e3o adicional com equipes e qualquer automa\u00e7\u00e3o que voc\u00ea queira empregar. Nossa se\u00e7\u00e3o final aborda isso com um pouco mais de detalhes.<\/p>\n Um dos maiores benef\u00edcios de usar a API da Kinsta \u00e9 a capacidade de automatizar tarefas repetitivas em seu fluxo de trabalho de desenvolvimento. Ao escrever scripts ou integrar-se a outras ferramentas, voc\u00ea pode simplificar os processos e economizar tempo.<\/p>\n Para otimizar totalmente o seu fluxo de trabalho, voc\u00ea pode automatizar o push do teste \u00e0 produ\u00e7\u00e3o integrando a API da Kinsta ao seu pipeline de CI\/CD. Esse pode ser um processo complexo e subjetivo que talvez at\u00e9 mude de projeto para projeto. Por exemplo, aqui est\u00e1 um exemplo de fluxo de trabalho para um script adequado:<\/p>\n Esse \u00e9 o grande ponto positivo da API da Kinsta. Voc\u00ea pode automatizar quase todos os aspectos do seu fluxo de trabalho para garantir implanta\u00e7\u00f5es consistentes e confi\u00e1veis. E ainda h\u00e1 muito mais que voc\u00ea pode fazer:<\/p>\n A beleza da API da Kinsta \u00e9 o quanto voc\u00ea pode controlar usando m\u00e9todos program\u00e1ticos. O escopo \u00e9 amplo, e voc\u00ea pode at\u00e9 mesmo criar pain\u00e9is personalizados<\/a> que mostrem algumas dessas m\u00e9tricas ou op\u00e7\u00f5es para um fluxo de trabalho de desenvolvimento ainda mais suave.<\/p>\n\n
Por que seus fluxos de trabalho de desenvolvimento podem se beneficiar da API da Kinsta<\/h2>\n
![\"O](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/mykinsta-dashboard-1.png\")
\n
Endpoints da API da Kinsta para desenvolvimento<\/h2>\n
\n
Um caso de uso no mundo real: impulsionando um site durante o desenvolvimento<\/h2>\n
\n
1. Configura\u00e7\u00e3o de um ambiente de desenvolvimento local<\/h3>\n
![\"The](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/devkinsta-splash.png\")
\n
![\"The](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/nginx-config.png\")
2. Gerenciando os ambientes de desenvolvimento local e de teste<\/h3>\n
Criando um ambiente de teste<\/h4>\n
![\"DevKinsta\u2019s](\"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>\nSincroniza\u00e7\u00e3o de altera\u00e7\u00f5es de local para teste<\/h4>\n
\n
![\"The](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/push-to-kinsta.png\")
![\"DevKinsta\u2019s](\"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. Transferindo altera\u00e7\u00f5es do teste para a produ\u00e7\u00e3o<\/h3>\n
\n
\n
Usando a API para implementar altera\u00e7\u00f5es<\/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\u00e1ticas e dicas t\u00edpicas para usar a API da Kinsta<\/h2>\n
\n
Automatizando seu fluxo de trabalho de desenvolvimento<\/h2>\n
\n
\n
Resumo<\/h2>\n