{"id":2006,"date":"2022-06-21T20:39:05","date_gmt":"2022-06-21T23:39:05","guid":{"rendered":"https:\/\/felipeelia.com.br\/?p=2006"},"modified":"2022-08-27T18:56:20","modified_gmt":"2022-08-27T21:56:20","slug":"o-que-e-uma-api","status":"publish","type":"post","link":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/","title":{"rendered":"O que \u00e9 uma API?"},"content":{"rendered":"\n<p>Voc\u00ea sabe o que \u00e9 uma API? Sabe por que \u00e9 importante usar APIs do seu framework favorito? Conhece os conceitos de interfaces e caixa preta? Neste post vamos falar sobre esses assuntos dando uma olhada em alguns exemplos.<\/p>\n\n\n\n<p>Comecei a pensar em um texto sobre os motivos de se usar as APIs do WordPress, mas precisei voltar em tantos conceitos que acabei <s>na separa\u00e7\u00e3o dos continentes<\/s> no conceito b\u00e1sico do que \u00e9 uma API. <strong>Esse post \u00e9 tanto para voc\u00ea, dev sandy\/junior, quanto para a galera s\u00eanior.<\/strong> E sim, vamos falar de conceitos, mas fique por a\u00ed porque estes s\u00e3o importantes.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>API \u00e9 a sigla para <strong>Application Programming Interface<\/strong>, ou seja, Interface de Programa\u00e7\u00e3o de Aplica\u00e7\u00f5es. <strong>Mas o que isso quer dizer?!<\/strong><\/p>\n<\/blockquote>\n\n\n\n<figure class=\"wp-block-image aligncenter size-medium\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/confused-macgyver.png\"><img loading=\"lazy\" decoding=\"async\" width=\"300\" height=\"225\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/confused-macgyver-300x225.png\" alt=\"MacGyver confuso com a frase &quot;I don't understand&quot; escrita\" class=\"wp-image-2025\" srcset=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/confused-macgyver-300x225.png 300w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/confused-macgyver-1024x768.png 1024w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/confused-macgyver-768x576.png 768w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/confused-macgyver-1067x800.png 1067w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/confused-macgyver.png 1398w\" sizes=\"(max-width: 300px) 100vw, 300px\" \/><\/a><\/figure>\n\n\n\n<p>&#8220;Programa\u00e7\u00e3o&#8221; e &#8220;aplica\u00e7\u00f5es&#8221; s\u00e3o as partes f\u00e1ceis. \u00c9 o &#8220;interface&#8221; que a gente precisa entender melhor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">O que \u00e9 uma <em>Interface<\/em>?<\/h2>\n\n\n\n<p>Interface nada mais \u00e9 do que a casquinha de fora de alguma coisa, <strong>a parte que se conecta com o exterior<\/strong>, mantendo o interior protegido.<\/p>\n\n\n\n<p>N\u00f3s lidamos com esse conceito todos os dias e, se n\u00e3o fosse por ele, a gente surtaria. Imagine ter que saber os detalhes de como cada coisa ao nosso redor funciona! Alguns exemplos de interfaces:<\/p>\n\n\n\n<ul><li><strong>Interface gr\u00e1fica:<\/strong> Voc\u00ea clica, o programa faz. N\u00e3o precisa saber como ele faz, o importante \u00e9 clicar no bot\u00e3o e ele realizar a a\u00e7\u00e3o que voc\u00ea espera.<\/li><li><strong>Atendimento em um restaurante:<\/strong> Voc\u00ea faz o pedido, recebe a comida. N\u00e3o importa quantos s\u00e3o os cozinheiros, a cor da panela ou a marca do fog\u00e3o.<\/li><li><strong>Sistema sensorial do corpo humano:<\/strong> Voc\u00ea n\u00e3o precisa fazer ideia de como o seu corpo faz com que voc\u00ea sinta cheiros ou o gosto da comida, ele vai fazer isso por voc\u00ea.<\/li><\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/caixa-eletronico.gif\"><img loading=\"lazy\" decoding=\"async\" width=\"640\" height=\"482\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/caixa-eletronico.gif\" alt=\"Mulher chegando a um caixa eletr\u00f4nico aberto, com um homem sentado dentro fazendo contas para dar o dinheiro.\" class=\"wp-image-2008\"\/><\/a><figcaption class=\"wp-element-caption\">Colocar o cart\u00e3o e a senha e receber o dinheiro \u00e9 tudo o que precisa acontecer. N\u00e3o importa se \u00e9 uma m\u00e1quina ou um cara fazendo contas.<\/figcaption><\/figure>\n\n\n\n<p>A ideia inteira \u00e9 baseada no conceito de entradas (<em>inputs<\/em>) e sa\u00eddas (<em>outputs<\/em>). Dada uma entrada se espera uma sa\u00edda, independente da implementa\u00e7\u00e3o:<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><td><\/td><td><strong>Entrada<\/strong><\/td><td><strong>Sa\u00edda<\/strong><\/td><\/tr><tr><td>Interface Gr\u00e1fica<\/td><td>Clique no bot\u00e3o<\/td><td>A\u00e7\u00e3o desejada<\/td><\/tr><tr><td>Atendimento em um restaurante<\/td><td>Realiza\u00e7\u00e3o do pedido<\/td><td>Entrega da comida<\/td><\/tr><tr><td>Sistema sensorial do corpo humano<\/td><td>Toque na pele<\/td><td>Sensa\u00e7\u00e3o relacionada (frio, calor, etc.)<\/td><\/tr><tr><td>Caixa eletr\u00f4nico<\/td><td>Inser\u00e7\u00e3o de cart\u00e3o e senha<\/td><td>Sa\u00edda do dinheiro<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Todo esse conceito de entrada-e-sa\u00edda-n\u00e3o-interessa-a-implementa\u00e7\u00e3o se chama <strong>caixa preta<\/strong>. H\u00e1 uma diferen\u00e7a importante aqui:<\/p>\n\n\n\n<ul><li><strong>Caixa preta \u00e9 como chamamos algo que aceita uma entrada e retorna uma sa\u00edda<\/strong>, sem necessariamente revelar como fez o processamento.<\/li><li><strong>Interface \u00e9 a forma como voc\u00ea se conecta com o sistema<\/strong>, qual \u00e9 exatamente a entrada esperada (um n\u00famero, dois n\u00fameros, uma string) e como ser\u00e1 a sa\u00edda (outro n\u00famero, outra string). \u00c9 como um contrato.<\/li><\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/caixa-preta-e-interface.jpg\"><img loading=\"lazy\" decoding=\"async\" width=\"595\" height=\"115\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/caixa-preta-e-interface.jpg\" alt=\"\" class=\"wp-image-2056\" srcset=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/caixa-preta-e-interface.jpg 595w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/caixa-preta-e-interface-300x58.jpg 300w\" sizes=\"(max-width: 595px) 100vw, 595px\" \/><\/a><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Interfaces na programa\u00e7\u00e3o<\/h3>\n\n\n\n<p>Aqui um breve par\u00eanteses. Al\u00e9m da letra I em API, ouvimos muito falar de interfaces em Orienta\u00e7\u00e3o a Objetos. A ideia \u00e9 exatamente a mesma: se uma classe diz que implementa uma determinada interface, ela obrigatoriamente precisa implementar os m\u00e9todos daquela interface. Vou deixar aqui o <a href=\"https:\/\/www.php.net\/manual\/pt_BR\/language.oop5.interfaces.php\">link para a documenta\u00e7\u00e3o oficial do PHP sobre interfaces<\/a>, mas deixe um coment\u00e1rio se esse \u00e9 um assunto que voc\u00ea gostaria de ver em outro post.<\/p>\n\n\n\n<p>Ah, e tem tamb\u00e9m a <a href=\"https:\/\/felipeelia.com.br\/wp-cli-wordpress-na-linha-de-comando\/\">WP-CLI<\/a>, que \u00e9 a interface de linha de comando \ud83d\ude42<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Tudo bem. A gente pode voltar a falar sobre APIs agora?<\/h2>\n\n\n\n<p>E \u00e9 agora que vai come\u00e7ar o post! Vamos voltar \u00e0 sigla:<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Interface<\/strong> <em>(conjunto de m\u00e9todos com entradas e sa\u00eddas cuja implementa\u00e7\u00e3o n\u00e3o interessa)<\/em><br><strong>de Programa\u00e7\u00e3o<\/strong> <em>(s\u00f3 d\u00e1 para acessar programando)<\/em><br><strong>de Aplica\u00e7\u00f5es<\/strong><\/p>\n<\/blockquote>\n\n\n\n<p>Ficou mais f\u00e1cil agora?<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-medium\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/agora-eu-entendi-bender-meme.jpg\"><img loading=\"lazy\" decoding=\"async\" width=\"300\" height=\"225\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/agora-eu-entendi-bender-meme-300x225.jpg\" alt=\"\" class=\"wp-image-2037\" srcset=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/agora-eu-entendi-bender-meme-300x225.jpg 300w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/agora-eu-entendi-bender-meme.jpg 480w\" sizes=\"(max-width: 300px) 100vw, 300px\" \/><\/a><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">APIs do WP<\/h2>\n\n\n\n<p>Quando eu tive a ideia de escrever esse post, eu queria falar sobre a import\u00e2ncia de se utilizar APIs internas no WordPress. O WordPress tem v\u00e1rias dessas APIs, inclusive j\u00e1 falamos de algumas delas por aqui: a <a href=\"https:\/\/felipeelia.com.br\/cache-facil-no-wordpress-transients-api\/\">API dos transients<\/a> e a <a href=\"https:\/\/felipeelia.com.br\/como-criar-uma-tela-de-configuracao-para-o-seu-plugin-wordpress-com-a-settings-api-parte-1\/\">API de configura\u00e7\u00f5es<\/a> s\u00e3o alguns exemplos. A lista completa de APIs do WordPress est\u00e1 dispon\u00edvel em <a href=\"https:\/\/developer.wordpress.org\/apis\/\">https:\/\/developer.wordpress.org\/apis\/<\/a>.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>Mas por que devemos usar essas APIs ao inv\u00e9s de simplesmente gravar alguma coisa diretamente no banco de dados ou salvar um arquivo no servidor?<\/p>\n<\/blockquote>\n\n\n\n<p>S\u00e3o v\u00e1rios os motivos, vamos ver alguns deles aqui embaixo. <\/p>\n\n\n\n<p><strong>Importante:<\/strong> esses conceitos n\u00e3o s\u00e3o isolados, mas complementares entre si. Tamb\u00e9m n\u00e3o tentei cobrir todos os aspectos, ent\u00e3o sinta-se a vontade para explorar qualquer outro aspecto na se\u00e7\u00e3o de coment\u00e1rios.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Separa\u00e7\u00e3o de responsabilidades<\/h2>\n\n\n\n<p>O termo em ingl\u00eas \u00e9 <em>Separation of concerns<\/em> e a tradu\u00e7\u00e3o varia entre separa\u00e7\u00e3o de responsabilidades, separa\u00e7\u00e3o de conceitos e separa\u00e7\u00e3o de preocupa\u00e7\u00f5es. Esse princ\u00edpio visa separar a aplica\u00e7\u00e3o em m\u00f3dulos, cada um respons\u00e1vel por uma coisa. Esses m\u00f3dulos se comunicam atrav\u00e9s de \u2014 voc\u00ea adivinhou \u2014 interfaces. Dessa forma, <strong>um c\u00f3digo que cria um produto fica separado do c\u00f3digo que lida com pedidos<\/strong> que, por sua vez, s\u00f3 chama o m\u00f3dulo respons\u00e1vel por gravar o pedido em algum lugar.<\/p>\n\n\n\n<p>H\u00e1 muitos anos, infelizmente era comum ver aplica\u00e7\u00f5es em PHP com v\u00e1rias chamadas a <code>mysqli_real_connect<\/code> e similares. Hoje essa n\u00e3o \u00e9 mais a realidade. No WordPress, por exemplo, temos a classe <code>wpdb<\/code> , outros frameworks usam ORM, mas sempre que \u00e9 necess\u00e1rio gravar\/salvar algum dado existe uma camada de abstra\u00e7\u00e3o.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/ruptura.gif\"><img loading=\"lazy\" decoding=\"async\" width=\"640\" height=\"267\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/ruptura.gif\" alt=\"\" class=\"wp-image-2039\"\/><\/a><figcaption class=\"wp-element-caption\">A s\u00e9rie &#8220;Ruptura&#8221; leva a separa\u00e7\u00e3o de responsabilidades a um OUTRO n\u00edvel.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Legibilidade<\/h2>\n\n\n\n<p><strong>N\u00f3s n\u00e3o escrevemos c\u00f3digo para computadores, mas para outros seres humanos<\/strong>, afinal &#8220;c\u00f3digo \u00e9 poesia&#8221; n\u00e3o \u00e9 \u00e0 toa. Por isso \u00e9 importante que seja f\u00e1cil olhar para um c\u00f3digo pela primeira vez e entender o que ele faz.<\/p>\n\n\n\n<p>O que \u00e9 mais f\u00e1cil de entender? Isso<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;?php\nglobal $wpdb;\n$wpdb-&gt;query(\n\t$wpdb-&gt;prepare(\n\t\t\"INSERT INTO `$wpdb-&gt;options` (`option_name`, `option_value`, `autoload`)\n\t\t\tVALUES (%s, %s, %s)\n\t\t\tON DUPLICATE KEY\n\t\t\tUPDATE\n\t\t\t\t`option_name` = VALUES(`option_name`),\n\t\t\t\t`option_value` = VALUES(`option_value`),\n\t\t\t\t`autoload` = VALUES(`autoload`)\", \n\t\t$option,\n\t\t$serialized_value,\n\t\t$autoload\n\t)\n);<\/code><\/pre>\n\n\n\n<p>ou isso?<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;?php\nupdate_option( 'my_option', 'value' );<\/code><\/pre>\n\n\n\n<p>A segunda op\u00e7\u00e3o, certo? Fica f\u00e1cil de entender que estamos salvando uma op\u00e7\u00e3o e se quisermos usar outro mecanismo de armazenagem como Redis ou Memcached (mais sobre isso abaixo), a parte do programa que est\u00e1 chamando a fun\u00e7\u00e3o <code>update_option()<\/code> n\u00e3o precisa ser alterada.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/code-is-poetry.jpg\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/code-is-poetry.jpg\" alt=\"\" class=\"wp-image-2040\" width=\"576\" height=\"323\" srcset=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/code-is-poetry.jpg 768w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/code-is-poetry-300x168.jpg 300w\" sizes=\"(max-width: 576px) 100vw, 576px\" \/><\/a><figcaption class=\"wp-element-caption\">C\u00f3digo \u00e9 poesia!<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Exemplos pr\u00e1ticos<\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>Usar as APIs do WordPress facilitam a vida. Muitas vezes, n\u00e3o usar as APIs inviabilizam o projeto.<\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\">A API de arquivos<\/h2>\n\n\n\n<p>Esse \u00e9 um caso cl\u00e1ssico. A pessoa programa o salvamento de arquivo usando as fun\u00e7\u00f5es <code>fopen<\/code>, <code>fclose<\/code>, etc. e tudo funciona bem. O projeto cresce um pouco, <strong>a infraestrutura precisa aumentar e os arquivos come\u00e7am a desaparecer<\/strong>. Vamos dar uma olhada em alguns diagramas para entender melhor.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Salvando direto no servidor (com s\u00f3 um web server)<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-1-salvando-direto-no-servidor.jpg\"><img loading=\"lazy\" decoding=\"async\" width=\"742\" height=\"131\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-1-salvando-direto-no-servidor.jpg\" alt=\"\" class=\"wp-image-2053\" srcset=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-1-salvando-direto-no-servidor.jpg 742w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-1-salvando-direto-no-servidor-300x53.jpg 300w\" sizes=\"(max-width: 742px) 100vw, 742px\" \/><\/a><\/figure>\n\n\n\n<p>At\u00e9 aqui d\u00e1 tudo certo. O administrador enviou o arquivo para o \u00fanico servidor e, quando o usu\u00e1rio visitar o site, o arquivo vai estar l\u00e1.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Salvando direto no servidor (com mais de um web server)<\/h3>\n\n\n\n<p>Agora vamos supor que \u00e9 preciso acrescentar um servidor. Na frente dos dois servidores colocamos um <em>Load balancer<\/em>, para direcionar o tr\u00e1fego ora para um, ora para outro.<\/p>\n\n\n\n<p>Se salvarmos o arquivo direto no servidor, ele s\u00f3 ficar\u00e1 gravado no servidor onde o usu\u00e1rio administrador enviou o arquivo, n\u00e3o sendo encontrado toda vez que a requisi\u00e7\u00e3o \u00e9 feita para outro web server.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-2-salvando-direto-no-servidor.jpg\"><img loading=\"lazy\" decoding=\"async\" width=\"814\" height=\"541\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-2-salvando-direto-no-servidor.jpg\" alt=\"\" class=\"wp-image-2054\" srcset=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-2-salvando-direto-no-servidor.jpg 814w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-2-salvando-direto-no-servidor-300x199.jpg 300w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-2-salvando-direto-no-servidor-768x510.jpg 768w\" sizes=\"(max-width: 814px) 100vw, 814px\" \/><\/a><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Salvando em um outro lugar<\/h3>\n\n\n\n<p>A solu\u00e7\u00e3o normalmente \u00e9 salvar os arquivos em outro lugar, como por exemplo um <a href=\"https:\/\/aws.amazon.com\/pt\/s3\/\">Bucket S3 da Amazon<\/a>. Poderia ser qualquer outro lugar, o importante \u00e9 que seja um lugar acess\u00edvel por todos os servidores.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-3-salvando-no-s3.jpg\"><img loading=\"lazy\" decoding=\"async\" width=\"839\" height=\"524\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-3-salvando-no-s3.jpg\" alt=\"\" class=\"wp-image-2055\" srcset=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-3-salvando-no-s3.jpg 839w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-3-salvando-no-s3-300x187.jpg 300w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/api-arquivos-wp-parte-3-salvando-no-s3-768x480.jpg 768w\" sizes=\"(max-width: 839px) 100vw, 839px\" \/><\/a><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Como fazer isso?<\/h3>\n\n\n\n<p>A solu\u00e7\u00e3o para esse nosso exemplo \u00e9 simples, \u00e9 s\u00f3 usar um <a href=\"https:\/\/github.com\/humanmade\/S3-Uploads\">plugin<\/a>.<\/p>\n\n\n\n<p>O importante \u00e9 que <strong>o plugin s\u00f3 vai funcionar no c\u00f3digo que estiver usando a API de arquivos do WordPress<\/strong>. Ele n\u00e3o vai ser capaz de alterar as chamadas diretas a <code>fopen<\/code>, s\u00f3 chamadas a <code>$wp_filesystem-&gt;put_contents()<\/code> ou fun\u00e7\u00f5es que passem pela API do WordPress.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">A API de transients<\/h2>\n\n\n\n<p>Se voc\u00ea ler <a href=\"https:\/\/felipeelia.com.br\/cache-facil-no-wordpress-transients-api\/\">o post sobre a API de transients<\/a> e a <a href=\"https:\/\/developer.wordpress.org\/apis\/handbook\/transients\/#function-reference\">documenta\u00e7\u00e3o oficial<\/a> vai ver que ela basicamente consiste em tr\u00eas fun\u00e7\u00f5es: <code>set_transient()<\/code>, <code>get_transient()<\/code> e <code>delete_transient()<\/code>. Voc\u00ea poderia implementar tr\u00eas fun\u00e7\u00f5es para salvar, pegar e excluir valores do banco de dados rapidamente, mas estaria perdendo uma das pe\u00e7as de infraestrutura usadas para melhoria de desempenho: <strong>armazenamento em mem\u00f3ria<\/strong>.<\/p>\n\n\n\n<p>Calma, eu explico. Quando falei sobre <a href=\"https:\/\/felipeelia.com.br\/tipos-de-plugin-do-wordpress\/\">tipos de plugin<\/a>, falei sobre os <em>drop-ins<\/em> e um deles \u00e9 o <code>object-cache.php<\/code>. Com ele, \u00e9 poss\u00edvel usar softwares como o Redis ou o Memcached, que guardam coisas na mem\u00f3ria, ao inv\u00e9s de usar o disco. <strong>Acesso a mem\u00f3ria \u00e9 muito mais r\u00e1pido que acesso a disco<\/strong> e, por isso, esses programas retornam coisas mais r\u00e1pido que o banco de dados.<\/p>\n\n\n\n<p>Se voc\u00ea estiver gravando coisas direto no banco de dados, colocar algo assim na sua infraestrutura n\u00e3o far\u00e1 diferen\u00e7a. Por outro lado, <strong>se estiver usando a API do WordPress, basta instalar e configurar um plugin<\/strong> com o seu <em>drop-in<\/em> e as coisas passar\u00e3o a funcionar automaticamente. Inclusive, se precisar trocar entre o Redis e o Memcached, a implementa\u00e7\u00e3o faz isso para voc\u00ea, afinal voc\u00ea est\u00e1 s\u00f3 usando a interface.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/redis-object-cache-plugin.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/redis-object-cache-plugin.png\" alt=\"\" class=\"wp-image-2048\" width=\"480\" height=\"216\" srcset=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/redis-object-cache-plugin.png 959w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/redis-object-cache-plugin-300x135.png 300w, https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/redis-object-cache-plugin-768x345.png 768w\" sizes=\"(max-width: 480px) 100vw, 480px\" \/><\/a><figcaption class=\"wp-element-caption\">Aqui no blog eu uso o <a href=\"https:\/\/br.wordpress.org\/plugins\/redis-cache\/\" target=\"_blank\" rel=\"noreferrer noopener\">Redis Object Cache<\/a><\/figcaption><\/figure>\n\n\n\n<p>N\u00e3o deixe de dar uma lida no post especial sobre <a href=\"https:\/\/felipeelia.com.br\/wordpress-object-cache-e-redis\/\">Object Cache e Redis<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">A API REST do WordPress<\/h2>\n\n\n\n<p>Eu j\u00e1 falei desse assunto antes, h\u00e1 alguns anos, mas ele ainda continua muito atual. Se voc\u00ea chegou at\u00e9 aqui querendo saber mais sobre a <a href=\"https:\/\/felipeelia.com.br\/a-api-rest-do-wordpress\/\">API REST do WP<\/a> d\u00e1 uma olhada nesse outro post. Tenho certeza de que voc\u00ea vai curtir!<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p>O post ficou gigante, eu sei. Se puder compartilhar nas suas redes sociais, assinar a newslette e deixar um coment\u00e1rio voc\u00ea ajuda demais. MUITO OBRIGADO!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Entenda o que \u00e9 uma API, por que \u00e9 importante usar APIs do seu framework favorito e conhe\u00e7a os conceitos de interfaces e caixa preta!<\/p>\n","protected":false},"author":1,"featured_media":2018,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","footnotes":""},"categories":[22,143,30],"tags":[151,150,45],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v21.9.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>O que \u00e9 uma API? | Felipe Elia<\/title>\n<meta name=\"description\" content=\"Entenda o que \u00e9 uma API, por que \u00e9 importante usar APIs do seu framework favorito e conhe\u00e7a os conceitos de interfaces e caixa preta!\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/\" \/>\n<meta property=\"og:locale\" content=\"pt_BR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"O que \u00e9 uma API? | Felipe Elia\" \/>\n<meta property=\"og:description\" content=\"Entenda o que \u00e9 uma API, por que \u00e9 importante usar APIs do seu framework favorito e conhe\u00e7a os conceitos de interfaces e caixa preta!\" \/>\n<meta property=\"og:url\" content=\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/\" \/>\n<meta property=\"og:site_name\" content=\"Felipe Elia\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/felipe.elia\" \/>\n<meta property=\"article:author\" content=\"https:\/\/www.facebook.com\/felipe.elia\" \/>\n<meta property=\"article:published_time\" content=\"2022-06-21T23:39:05+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-08-27T21:56:20+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1920\" \/>\n\t<meta property=\"og:image:height\" content=\"1080\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Felipe Elia\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@https:\/\/twitter.com\/felipe_elia\" \/>\n<meta name=\"twitter:site\" content=\"@felipe_elia\" \/>\n<meta name=\"twitter:label1\" content=\"Escrito por\" \/>\n\t<meta name=\"twitter:data1\" content=\"Felipe Elia\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. tempo de leitura\" \/>\n\t<meta name=\"twitter:data2\" content=\"11 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/\"},\"author\":{\"name\":\"Felipe Elia\",\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"headline\":\"O que \u00e9 uma API?\",\"datePublished\":\"2022-06-21T23:39:05+00:00\",\"dateModified\":\"2022-08-27T21:56:20+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/\"},\"wordCount\":1633,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"keywords\":[\"API\",\"PHP\",\"WordPress\"],\"articleSection\":[\"PHP\",\"Programa\u00e7\u00e3o\",\"WordPress\"],\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/\",\"url\":\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/\",\"name\":\"O que \u00e9 uma API? | Felipe Elia\",\"isPartOf\":{\"@id\":\"https:\/\/felipeelia.com.br\/#website\"},\"datePublished\":\"2022-06-21T23:39:05+00:00\",\"dateModified\":\"2022-08-27T21:56:20+00:00\",\"description\":\"Entenda o que \u00e9 uma API, por que \u00e9 importante usar APIs do seu framework favorito e conhe\u00e7a os conceitos de interfaces e caixa preta!\",\"breadcrumb\":{\"@id\":\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/#breadcrumb\"},\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/felipeelia.dev\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"O que \u00e9 uma API?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/felipeelia.com.br\/#website\",\"url\":\"https:\/\/felipeelia.com.br\/\",\"name\":\"Felipe Elia\",\"description\":\"Programa\u00e7\u00e3o com WordPress de um jeito f\u00e1cil, do b\u00e1sico ao avan\u00e7ado\",\"publisher\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/felipeelia.com.br\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"pt-BR\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\",\"name\":\"Felipe Elia\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg\",\"contentUrl\":\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg\",\"width\":400,\"height\":400,\"caption\":\"Felipe Elia\"},\"logo\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/\"},\"description\":\"Associate Director of Platform Engineering na 10up, WordPress Core Contributor, Global Polyglots Mentor na comunidade internacional do WordPress e Locale Manager na comunidade WordPress Brasil.\",\"sameAs\":[\"https:\/\/www.facebook.com\/felipe.elia\",\"https:\/\/www.instagram.com\/felipe.elia\/\",\"https:\/\/www.linkedin.com\/in\/felipeelia\/\",\"https:\/\/twitter.com\/https:\/\/twitter.com\/felipe_elia\",\"https:\/\/www.youtube.com\/channel\/UCD_26rOE3ClALcZreTkyIoQ\"],\"url\":\"https:\/\/felipeelia.com.br\/author\/admin\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"O que \u00e9 uma API? | Felipe Elia","description":"Entenda o que \u00e9 uma API, por que \u00e9 importante usar APIs do seu framework favorito e conhe\u00e7a os conceitos de interfaces e caixa preta!","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/","og_locale":"pt_BR","og_type":"article","og_title":"O que \u00e9 uma API? | Felipe Elia","og_description":"Entenda o que \u00e9 uma API, por que \u00e9 importante usar APIs do seu framework favorito e conhe\u00e7a os conceitos de interfaces e caixa preta!","og_url":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/","og_site_name":"Felipe Elia","article_publisher":"https:\/\/www.facebook.com\/felipe.elia","article_author":"https:\/\/www.facebook.com\/felipe.elia","article_published_time":"2022-06-21T23:39:05+00:00","article_modified_time":"2022-08-27T21:56:20+00:00","og_image":[{"width":1920,"height":1080,"url":"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask.jpg","type":"image\/jpeg"}],"author":"Felipe Elia","twitter_card":"summary_large_image","twitter_creator":"@https:\/\/twitter.com\/felipe_elia","twitter_site":"@felipe_elia","twitter_misc":{"Escrito por":"Felipe Elia","Est. tempo de leitura":"11 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/#article","isPartOf":{"@id":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/"},"author":{"name":"Felipe Elia","@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"headline":"O que \u00e9 uma API?","datePublished":"2022-06-21T23:39:05+00:00","dateModified":"2022-08-27T21:56:20+00:00","mainEntityOfPage":{"@id":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/"},"wordCount":1633,"commentCount":0,"publisher":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"keywords":["API","PHP","WordPress"],"articleSection":["PHP","Programa\u00e7\u00e3o","WordPress"],"inLanguage":"pt-BR","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/felipeelia.com.br\/o-que-e-uma-api\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/","url":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/","name":"O que \u00e9 uma API? | Felipe Elia","isPartOf":{"@id":"https:\/\/felipeelia.com.br\/#website"},"datePublished":"2022-06-21T23:39:05+00:00","dateModified":"2022-08-27T21:56:20+00:00","description":"Entenda o que \u00e9 uma API, por que \u00e9 importante usar APIs do seu framework favorito e conhe\u00e7a os conceitos de interfaces e caixa preta!","breadcrumb":{"@id":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/#breadcrumb"},"inLanguage":"pt-BR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/felipeelia.com.br\/o-que-e-uma-api\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/felipeelia.com.br\/o-que-e-uma-api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/felipeelia.dev\/"},{"@type":"ListItem","position":2,"name":"O que \u00e9 uma API?"}]},{"@type":"WebSite","@id":"https:\/\/felipeelia.com.br\/#website","url":"https:\/\/felipeelia.com.br\/","name":"Felipe Elia","description":"Programa\u00e7\u00e3o com WordPress de um jeito f\u00e1cil, do b\u00e1sico ao avan\u00e7ado","publisher":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/felipeelia.com.br\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"pt-BR"},{"@type":["Person","Organization"],"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292","name":"Felipe Elia","image":{"@type":"ImageObject","inLanguage":"pt-BR","@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/","url":"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg","contentUrl":"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg","width":400,"height":400,"caption":"Felipe Elia"},"logo":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/"},"description":"Associate Director of Platform Engineering na 10up, WordPress Core Contributor, Global Polyglots Mentor na comunidade internacional do WordPress e Locale Manager na comunidade WordPress Brasil.","sameAs":["https:\/\/www.facebook.com\/felipe.elia","https:\/\/www.instagram.com\/felipe.elia\/","https:\/\/www.linkedin.com\/in\/felipeelia\/","https:\/\/twitter.com\/https:\/\/twitter.com\/felipe_elia","https:\/\/www.youtube.com\/channel\/UCD_26rOE3ClALcZreTkyIoQ"],"url":"https:\/\/felipeelia.com.br\/author\/admin\/"}]}},"uagb_featured_image_src":{"full":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask.jpg",1920,1080,false],"thumbnail":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask-150x150.jpg",150,150,true],"medium":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask-300x169.jpg",300,169,true],"medium_large":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask-768x432.jpg",768,432,true],"large":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask-1024x576.jpg",1024,576,true],"1536x1536":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask-1536x864.jpg",1536,864,true],"2048x2048":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask.jpg",1920,1080,false],"ocean-thumb-m":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask.jpg",600,338,false],"ocean-thumb-ml":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask.jpg",800,450,false],"ocean-thumb-l":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask.jpg",1200,675,false],"yarpp-thumbnail":["https:\/\/felipeelia.com.br\/wp-content\/uploads\/2022\/06\/mib-alien-behind-mask-120x120.jpg",120,120,true]},"uagb_author_info":{"display_name":"Felipe Elia","author_link":"https:\/\/felipeelia.com.br\/author\/admin\/"},"uagb_comment_info":0,"uagb_excerpt":"Entenda o que \u00e9 uma API, por que \u00e9 importante usar APIs do seu framework favorito e conhe\u00e7a os conceitos de interfaces e caixa preta!","_links":{"self":[{"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/posts\/2006"}],"collection":[{"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/comments?post=2006"}],"version-history":[{"count":0,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/posts\/2006\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/media\/2018"}],"wp:attachment":[{"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/media?parent=2006"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/categories?post=2006"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/tags?post=2006"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}