A integração de API permite usar serviços que, de outra forma, levariam muito tempo para codificar por conta própria. Em particular, a API REST do WordPress permite que você conecte seu site WordPress com aplicações externas. Hoje em dia, elas são essenciais para o sucesso dos negócios digitais.
Se você é um parceiro de anúncios da Grumft, seja bem-vindo ao nosso blog. Mas se ainda não é, esperamos que este conteúdo te motive a conhecer nossas soluções exclusivas de programática para publishers, desenvolvedores de aplicativos e anunciantes. Nesse artigo, trouxemos algumas respostas sobre integração de API e nos aprofundaremos um pouco mais na API REST do WordPress.
Index
O que é uma API?
API significa Application Programming Interface, em português Interface de Programação de Aplicação. Entenda o que é uma interface.
O que é uma interface?
Cada dispositivo que usamos tem algum tipo de interface, como por exemplo o botão ligar da TV, o interruptor que você aciona para acender uma lâmpada, entre outras interfaces que você precisa acionar para fazer com que o dispositivo faça o que você quer.
Ou seja, você não precisa entender de como a TV funciona ou como é o circuito elétrico para acender a lâmpada, você só precisa usar a interface que nos foi exposta.
O que é a “programação de aplicação” na API?
Uma API é como as aplicações se comunicam. Todos os softwares com os quais o seu site interage por meio de código, têm uma API.
Quando um webmaster fala sobre “integrar uma API”, ele está se referindo a um serviço da web que permite enviar solicitações e receber dados em troca. Portanto, quando você precisa que um código faça o que você quer no site, antes de tudo entenda a documentação da API relacionada a esse código e integrar ao site.
Como funcionam as APIs da Web?
Seja qual for o navegador da Web, existem muitas APIs incorporadas a ele. Elas são chamadas de APIs da Web. Elas tem diversas finalidades, como reproduzir um vídeo ou arquivos de áudio, controlar um vídeo game e muito mais. Toda vez que você ouve um clique ou uma tecla pressionada em JavaScript, você está usando a API da Web de eventos para fazer isso.
Mas também existem as APIs da Web HTTP. Essas são APIs que ficam entre o código do seu site e algumas fontes de dados ou funcionalidades em um servidor que ele acessa. Eles geralmente usam o estilo de arquitetura da API REST, um conjunto de restrições arquitetônicas, que os desenvolvedores de API implementam para atender a determinados critérios ao fazer solicitações HTTP.
Uma API geralmente faz duas coisas: define regras para interagir e trata da transferência de dados.
1. Regras
As regras são como se a API dissesse: “se você estruturar sua solicitação assim , enviarei dados estruturados assim”. Mas se você não estruturar a sua solicitação de uma maneira que a API entenda, ela retornará com um erro na resposta.
2. Transferência de dados
Uma API também trata da transferência de dados entre o servidor e o código que faz a solicitação. A API é um programa que atua como intermediário entre uma aplicação web e o servidor e banco de dados. Quando ela recebe uma solicitação válida, ele executa a função (ou várias), abstraindo toda a complexidade da função para o usuário.
Conceitos APIs HTTP
Existem alguns conceitos que você precisa entender sobre APIs HTTP:
Endpoints
As APIs fornecem um endpoint ou uma URL específica onde os dados ou funções que você deseja são expostos. Para a API de origem do Imagify, por exemplo, que torna uma página da Web mais leve, rápida, melhora a experiência do usuário e o SEO, por meio do endpoint ao compactar as imagens que você fez upload na galeria do WordPress. Ele faz o upload automaticamente via API para os servidores da Imagify, e retorna como resposta a imagem já compactada no formato webp.
Autenticação
Algumas APIs exigem que você se inscreva em uma conta ou obtenha uma chave exclusiva para acessar suas informações. Pode ser para proteger os dados, impedir abuso do serviço ou para cobrar pela utilização.
Se você estiver alterando dados em seu banco de dados por meio de uma API, precisará de autenticação. Com a autenticação, você passa à API uma chave secreta que identifica um usuário específico ou solicitação de aplicação. O servidor pode determinar se você pode acessar os dados ou não. Se uma API exigir autenticação, a documentação da API explicará como isso funciona.
HTTP Verbs
Com cada solicitação HTTP criada, há sempre um ‘ HTTP Verb ‘ que a acompanha. Os mais comuns são GET, POST, PUT, DELETE e POST.
- GET: recupera um recurso do servidor (como um dado específico);
- POST: adiciona um recurso ao servidor;
- PUT: edita ou atualiza um recurso que já está no servidor;
- DELETE: remove um recurso do servidor.
Embora existam outros HTTP Verbs, neste artigo alisaremos apenas as APIs públicas, principalmente a REST API do WordPress.
JSON
Uma API HTTP recebe e transmite dados no formato JSON (JavaScript Object Notation). O JSON é um modelo para armazenamento e transmissão de informações no formato texto.
Apesar de muito simples, as aplicações Web usa o JSON por sua capacidade de estruturar informações de uma forma bem mais compacta do que o modelo XML. Empresas como Google e Yahoo, cujas aplicações precisam transmitir grandes volumes de dados utilizam o JSON.
Exemplos de integração de API
Os sites de comércio eletrônico estão entre os usuários mais significativos de integração de API. Os e-commerce precisam integrar sistemas de gerenciamento de pedidos, estoque, gateway de pagamento, entre outros.
Mas alguns publishers também podem precisar integrar APIs, que dependendo do negócio, podem ser tão complexas quanto as integrações do e-commerce. Um exemplo disso é a integração da API do Google Ad Manager, que pode ser difícil de realizar mesmo o Google disponibilizando todos os documentos.
Publishers e Equipes de Desenvolvedores
Nem todo publisher é desenvolvedor. Quando esse é o caso, o publishers tem uma equipe interna ou terceiriza o gerenciamento do site, que inclui integração de APIs.
A maior parte dos sites onde existe uma equipe terceirizada no gerenciamento, são desenvolvidos em WordPress. Se esse é o seu caso, já deve ter ouvido falar sobre a REST API. Mas se ainda não conhece esse termo, vamos esclarecer algumas questões sobre a REST API do WordPress que você ainda possa ter.
Integração de API em WordPress
Mesmo que os detalhes técnicos sejam complexos, o conceito básico desse recurso não é difícil de entender. A REST API ajuda a expandir o que o WordPress pode fazer e torna mais simples integrar o WordPress a outros sites e aplicações.
Regras fundamentais de uma REST API
Como você já sabe, REST API (Representational State Transfer) é um conjunto de restrições arquitetônicas que os desenvolvedores de API implementam para atender a determinados critérios ao fazer solicitações HTTP.
Para entender como as REST APIs funcionam, você precisa saber em quais as restrições elas funcionam. Cinco elementos básicos tornam uma ‘RESTful’ API. Vale ressaltar que o ‘servidor’ é a plataforma à qual a API pertence e o ‘cliente’ é o site, aplicativo ou software que se conecta a plataforma:
1. Arquitetura cliente-servidor
A API deve ser construída de forma que o cliente e o servidor permaneçam separados um do outro. Dessa forma, eles podem continuar a se desenvolver por conta própria e podem ser usados de forma independente.
2. Stateless
As REST APIs devem seguir um protocolo Stateless. Ou seja, eles não podem armazenar nenhuma informação sobre o cliente no servidor. A solicitação do cliente deve incluir todos os dados necessários antecipadamente e a resposta deve fornecer tudo o que o cliente precisa. Isso torna cada interação única, o que reduz os requisitos de memória e erros em potencial.
3. Cacheability
Um ‘cache’ é o armazenamento temporário de dados específicos, para que possam ser recuperados e enviados mais rápido. As RESTful APIs usam dados que podem ser armazenados em cache sempre que possível, para melhorar a velocidade e a eficiência. Além disso, a API precisa informar ao cliente se cada dado pode e deve ser armazenado em cache .
4. Layered system
REST APIs bem projetadas são construídas usando camadas, cada uma com sua própria funcionalidade designada. Essas camadas interagem, mas permanecem separadas. Isso torna a API mais fácil de modificar e atualizar e melhorar sua segurança.
5. Interface uniforme
Todas as partes de uma REST API precisam funcionar por meio da mesma interface e se comunicar usando as mesmas linguagens. Essa interface deve ser projetada especificamente para a API e capaz de evoluir por conta própria. Não deve depender do servidor ou cliente para funcionar.
Toda API que segue essas restrições pode ser considerada RESTful. Existe também uma sexta restrição, que é opcional e nem toda REST API adota. Ela é conhecida como ‘code on demand’, que permite a API instruir o servidor a transmitir código para um cliente, a fim de estender sua funcionalidade.
REST API do WordPress
Pode ser que agora você esteja se perguntando, como tudo isso afeta o seu site. Mas a resposta é simples: além de excelentes ferramentas, as APIs são essenciais em sites construídos em WordPress.
Até pouco tempo, a REST API era como um plugin independente, mas a partir de 2016, ela tornou-se a API do WordPress, pois de acordo com o site do projeto, o WordPress está caminhando para se tornar um “framework de aplicação completa”. Ou seja, a REST API permite que a plataforma interaja com praticamente qualquer site e aplicativo da web. Além disso, ele pode se comunicar e trocar dados independentemente de quais idiomas um programa externo usa.
Às vezes a REST API também pode ser chamada de REST API JSON do WordPress. Isso descreve o formato que esta API usa para trocar dados. Esse formato baseia-se em JavaScript, conforme você já viu anteriormente neste mesmo conteúdo.
É possível implementar uma infinidade de aplicações usando a API REST do WordPress. Se você quiser saber mais sobre como funciona, recomendamos começar com os seguintes recursos:
- O Manual da REST API: recurso oficial do WordPress que documenta todo tipo de informação sobre a REST API. Você também encontra uma lista de endpoints que pode usar, bem como detalhes sobre alguns dos aspectos estruturais da REST API não abordadas neste artigo.
- Tutoriais do W3Schools: esse recurso não é específico da REST API, mas oferece tutoriais úteis que podem ajudar a aprimorar os principais conceitos, como métodos HTTP e JSON .
A REST API do WordPress é um tópico complexo, até mesmo para desenvolvedores. Mas se você é publisher e tem um site em WordPress, vale a pena entender o básico e o que a REST API torna possível.
Pensamentos Finais sobre Integração de API em WordPress
Hoje em dia, a integração de API é fundamental para garantir um site em WordPress rápido, com design atraente, eficiente entrega de anúncios e bom rankeamento.
Mesmo para não desenvolvedores, compreender a essência da REST API como uma interface de comunicação entre programas, com restrições definidas, não é complexo. Em sua jornada, você pode sempre contar com o suporte da Grumft.
