WordPress é o CMS mais popular em uso atualmente. Por que? Porque se integra facilmente com milhares de ferramentas para melhorar o desempenho e a funcionalidade do seu site.
Essas ferramentas cobrem uma ampla gama de setores, mas os usuários ficam constantemente impressionados com a quantidade de ferramentas disponíveis para comércio eletrônico. Uma das ferramentas de comércio eletrônico mais poderosas é a API WooCommerce.
Compreendendo a API WooCommerce
A API do WooCommerce possui três componentes principais. Para entender o quão poderosa essa API pode ser, vamos dar uma olhada em cada componente individualmente.
API REST
A API REST do WooCommerce permite que os usuários acessem sua loja WooCommerce de fora do site. Este design permitirá que você acesse sua loja a partir de outros aplicativos de internet como Shopify, por exemplo.
Em última análise, a API REST facilita o gerenciamento da sua loja. Você pode acessar sua loja WooCommerce a partir dos painéis de outros aplicativos e ainda ter acesso à funcionalidade completa de administração do WooCommerce.
API legada
Habilitar a API legada costumava ser a forma como você ativaria sua API para WooCommerce. No entanto, esta parte do processo está se tornando obsoleta nas versões mais recentes.
A versão mais recente é a API REST WooCommerce. Integra-se diretamente com a API do WordPress. A API Legacy é a versão mais antiga do WooCommerce. Os usuários devem verificar suas configurações, pois o WooCommerce tende a iniciar a API legada por padrão.
Webhooks
Webhooks permitem que o WooCommerce “chame” outros aplicativos. Por exemplo, se quiser que as ações no WooCommerce sejam acionadas por ações realizadas em outros aplicativos, você pode usar um webhook.
A API faz isso usando URLs. Você pode enviar um alerta de notificação por meio da API para um URL específico. Esses URLs podem causar eventos em um site específico, desencadeando outra ação em um site ou página separada.
Venda seus produtos online, sem preocupações
Oficialmente recomendada pela WooCommerce, nossa hospedagem é feita para negócios online como o seu
Terminologia principal da API WooCommerce
Ao percorrer a documentação da API do WooCommerce, você encontrará alguma terminologia exclusiva do WooCommerce. Vamos revisar esses termos e definições para ajudá-lo em seu processo de API.
Formato de solicitação/resposta
Isso indica o formato que o WooCommerce usará para transmitir determinados tipos de dados. É importante estar ciente dos diferentes tipos de dados porque determinados URLs e gatilhos não funcionarão se não receberem dados no formato adequado.
O formato padrão para a maioria dos dados na API WooCommerce é JSON. As datas do calendário retornam como números inteiros, e qualquer número (como dinheiro, preços ou totais) estará em uma sequência de texto e terá como padrão duas casas decimais. Qualquer coisa deixada em branco retornará como uma string vazia ou “nula”.
Autenticação
O processo de autenticação permite a integração da API WooCommerce. Os usuários podem conectar a API a outras plataformas usando chaves de API.
Para gerar uma chave API WooCommerce, você precisa acessar suas configurações. Duas chaves estão disponíveis para usuários do WooCommerce, uma chave secreta e uma chave do consumidor.
As chaves do consumidor também são conhecidas como chaves gerais ou de API. Essas chaves são emitidas para um usuário em diferentes plataformas. As chaves da API WooCommerce permitem que você se conecte a outras plataformas como WordPress, Shopify, etc.
A chave secreta se comporta de maneira semelhante para determinados aplicativos e plataformas. Quando você conecta ferramentas ou aplicativos de terceiros ao WooCommerce, a Chave Geral ou do Consumidor atuará como o “nome de usuário” de suas credenciais de login, enquanto a Chave Secreta atuará como sua senha.
Pontos finais
Em termos de tecnologia API, um endpoint é o ponto em que a API interage com outro aplicativo ou plataforma. Um exemplo de endpoint seria o URL de uma plataforma específica, como Shopify ou Facebook.
Configurando a API WooCommerce
O processo de configuração da API WooCommerce é relativamente simples. Siga as etapas abaixo para vincular todas as suas ferramentas à plataforma e transformar a experiência de compra do seu cliente no comércio eletrônico.
Você precisará navegar pelos seguintes menus no painel do WordPress:
WooCommerce>Configurações>Avançado>API legada
Há uma caixa de seleção para indicar se a API está habilitada ou não. Certifique-se de que a caixa esteja marcada, clique em salvar alterações e o acesso à API estará disponível.
Como criar chaves API no WooCommerce
As chaves de API são a espinha dorsal das funções da API WooCommerce. É hora de criar alguns para conectar suas ferramentas e plataformas favoritas. Siga as etapas abaixo para fazer isso.
1. Adicionar chave
Você precisará criar uma nova chave para cada aplicativo ou plataforma conectada ao WooCommerce. A API irá gerar uma Chave do Consumidor e uma Chave Secreta para cada nova conexão que você criar.
Você precisará acessar o menu REST API para adicionar uma chave. Veja como você pode encontrá-lo:
WooCommerce>Configurações>Avançado>API REST
Quando estiver lá, clique Adicionar chave.
2. Defina as principais configurações
Depois de clicar em “Adicionar chave”, há algumas decisões que você precisará tomar. Para cada chave criada, você precisará definir as seguintes configurações:
- Descrição – É aqui que você pode “nomear” cada chave da plataforma correspondente para ajudar a organizá-las
- Proprietário – Atribua uma chave ao usuário específico responsável por ela dentro de sua equipe
- Permissões – Eles determinam quais funções você está concedendo a essa chave específica. Por exemplo, se precisar de uma chave específica para excluir ou ajustar dados, você precisará conceder “Permissões de leitura/gravação”.
3. Geração de API
Assim que a configuração das configurações estiver concluída, você clicará no botão “Gerar chave” na parte inferior da tela. A próxima página que você acessar conterá uma Chave do Consumidor e uma Chave Secreta, e um código QR para esta conexão.
Depois de sair da página Geração de API, você não poderá voltar. Portanto, copie essas chaves em outro documento do Word ou Notes e guarde-as. Você precisará deles para se conectar à configuração do WooCommerce.
4. Usando chaves para conectar-se a aplicativos de terceiros
Agora, com suas chaves de API geradas, podemos começar a nos conectar a aplicativos e plataformas de terceiros, conhecidos como “clientes de API”. Você precisará seguir as etapas em ambos os lados da conexão no menu WooCommerce no WordPress e no aplicativo escolhido.
Cada plataforma é diferente, então você precisará acessar os recursos de ajuda dessa plataforma específica. Procure dicas sobre como acessar as credenciais de autorização do aplicativo.
A maioria das plataformas oferece vários tipos de autorização. Você desejará selecionar Autorização Básica.
Copie e cole sua chave de API geral ou de consumidor na barra “Nome de usuário” e use sua chave secreta como senha. Ao fazer isso, você conectou com sucesso o WooCommerce a uma de suas outras ferramentas poderosas de comércio eletrônico. A próxima etapa é começar a fazer solicitações de API.
Como fazer solicitações de API WooCommerce
As solicitações de API são onde a mágica acontece. Essas solicitações tornam possíveis todas as funções “legais” que facilitarão sua vida. Essas solicitações vêm em dois formatos – GET ou PUT. Siga as etapas abaixo para configurá-los entre ferramentas.
1. Teste uma solicitação GET
As solicitações GET são úteis para obter dados de outras fontes, como o nome sugere. Um exemplo prático de comércio eletrônico seria obter uma lista de seus produtos WooCommerce. Fazer isso requer algum conhecimento técnico, mas se você seguir as instruções, tudo ficará bem.
Para executar esta função GET, você precisará digitar o seguinte URL:
https://seusite.com/wp-json/wc/v3/products
Naturalmente, você desejará inserir seu URL onde diz “seu site”. Quando executado, este GET extrairá todos os dados dos seus produtos listados no WooCommerce.
A integração da API WooCommerce retornará esses dados para você em formato JSON. Se feito corretamente, a plataforma que você conecta ao WooCommerce analisará esses dados para que fiquem em um formato fácil e utilizável para seus usuários finais.
Se você executar esta função GET e receber um 401 ou outro código numerado, significa que há algum erro. Talvez seja necessário voltar ou consultar mais recursos de ajuda da plataforma para solucionar problemas. Se a solicitação GET for feita corretamente, você deverá ver a string JSON na seção “Corpo” do seu painel.
2. Teste uma solicitação PUT
Usando os dados da nossa solicitação GET na etapa 1, você também desejará verificar uma solicitação PUT. Para nosso exemplo, digamos que o produto que estamos usando para esta solicitação tenha um ID de produto 101. Para executar a solicitação GET, nosso URL terá uma aparência um pouco diferente:
https://seusite.com/wp-json/wc/v3/products/101
O processo para tornar esta função PUT em vez de GET é simples:
- Ao lado do campo URL, há um menu suspenso
- Selecione-o e mude a função de GET para PUT
- No painel Corpo do painel, escolha a opção “Raw”.
- Abra o menu suspenso “texto” e selecione JSON
Concluídas essas etapas, você já pode fazer sua solicitação. Um exemplo de uso disso seria se você quisesse alterar o preço do produto nº 101. Para fazer isso, você digitaria o seguinte texto:
{ “preço_regular”: “50” }
Depois disso, você pode disponibilizar os resultados em seu site clicando em Enviar.
Solicitações úteis de API de comércio eletrônico
Várias solicitações de API serão úteis em sua loja de comércio eletrônico. Pode ser necessária uma pesquisa para encontrar uma solicitação de API que faça exatamente o que você está procurando, mas listamos algumas solicitações básicas abaixo para você começar.
OBTER solicitações
Aqui estão os URLs para algumas solicitações GET que você pode colocar em ação em sua loja de comércio eletrônico:
- OBTENHA todos os produtos: https://seusite.com/wp-json/wc/v3/products/
- OBTENHA todos os clientes: https://seusite.com/wp-json/wc/v3/customers/
- OBTENHA um único cliente: https://yoursite.com/wp-json/wc/v3/customers/{ID do cliente}
- OBTENHA todas as categorias de produtos: https://seusite.com//wp-json/wc/v3/products/categories
- OBTENHA uma variação do produto: https://yoursite.com/wp-json/wc/v3/products/{ID do produto}/variações/{ID da variação}
- OBTENHA um único produto: https://seusite.com/wp-json/wc/v3/products/{ID do produto}
Solicitações PUT
Aqui estão algumas solicitações básicas de PUT que você pode achar úteis para sua loja.
{ “id”: 1, “nome”: “Cor”, “slug”: “pa_color”, “tipo”: “select”, “order_by”: “nome”, “has_archives”: true, “_links”: { “auto”: [
{
“href”: “https://example.com/wp-json/wc/v3/products/attributes/6″
}
]”coleção”: [
{
“href”: “https://example.com/wp-json/wc/v3/products/attributes”
}
]
} }
{ “primeiro_nome”: “John”, “sobrenome”: “Doe” }
{ “preço_regular”: “81” }
{ “preço_regular”: “50”, “quantidade_estoque”: 30 }
{ “shipping”: { “first_name”: “Jane”, “last_name”: “Doe”, “company”: “Jane Doe Co”, “address_1”: “361 Outside Rd”, “address_2”: “Suite 101” , “cidade”: “Las Vegas”, “estado”: “NV”, “código postal”: “89102”, “país”: “EUA” } }
{ “id”: 20, “date_created”: “2018-09-08T21:47:19”, “date_created_gmt”: “2018-09-09T00:47:19”, “product_id”: 31, “status”: ” aprovado”, “reviewer”: “Claudio Sanches”, “reviewer_email”: “[email protected]”, “review”: “Agora funciona perfeitamente.”, “rating”: 5, “verified”: true, “reviewer_avatar_urls”: { “24”: “https://secure.gravatar.com/avatar/908480753c07509e76322dc17d305c8b?s=24&d=mm&r=g”, “48”: “https://secure.gravatar.com/avatar/ 908480753c07509e76322dc17d305c8b?s=48&d=mm&r=g”, “96”: “https://secure.gravatar.com/avatar/908480753c07509e76322dc17d305c8b?s=96&d=mm&r=g” }, “_links”: { “eu”: [
{
“href”: “https://example.com/wp-json/wc/v3/products/reviews/20″
}
]”coleção”: [
{
“href”: “https://example.com/wp-json/wc/v3/products/reviews”
}
]”acima”: [
{
“href”: “https://example.com/wp-json/wc/v3/products/31″
}
]”revisor”: [
{
“embeddable”: true,
“href”: “https://example.com/wp-json/wp/v2/users/1”
}
]
} }
Uso avançado da API WooCommerce
Além do básico, os usuários também podem aproveitar a API WooCommerce para lidar com algumas funções avançadas de sua loja de comércio eletrônico. Alguns dos recursos avançados do WooCommerce são:
- Paginação personalizada – API WooCommerce permite que os usuários criem um número de item personalizado por página para se adequar ao estilo e layout de seu site
- Webhooks – Os usuários podem programar webhooks WooCommerce para acionar eventos em outros sites. As vitrines de comércio eletrônico podem usar isso para ajudar com as opções de envio, embalagem, processo de devolução do WooCommerce e muito mais
- Tarefas assíncronas – As lojas podem acionar tarefas assíncronas para serem acionadas separadamente após um pedido ser pago ou um cliente criar uma conta com sua marca
- Filtrando e classificando dados – Você pode adicionar campos personalizados aos produtos WooCommerce e implementar recursos de classificação personalizados para melhorar a experiência do cliente
Melhores práticas e dicas do WooCommerce
A API WooCommerce oferece muita liberdade para personalizar sua loja de comércio eletrônico. É importante não “personalizar demais” e adicionar muitos “sinos e assobios” à sua loja de comércio eletrônico. Aqui estão algumas práticas recomendadas que você deve ter em mente ao personalizar sua loja de comércio eletrônico.
Use um plug-in
Se você planeja apenas fazer pequenas alterações em sua loja, considere usar um plugin. Tudo é tratado no painel e não requer código adicional ou sequências de texto.
JetPack para WordPress é um plugin útil para personalização básica do WooCommerce. Se as atualizações que você está fazendo envolvem apenas alterações na folha de estilo ou no feed CSS, esta opção é para você.
Além disso, existem muitas opções de plugins CSS disponível se você deseja ter CSS global que não seja perdido quando você altera o tema ativo ou o tema filho.
Use um tema filho
Após atualizar a folha de estilo ou CSS, eles podem ser redefinidos a cada atualização do seu site. Para manter suas personalizações enquanto o WordPress continua atualizando seu site, considere usar um tema filho.
O tema filho permite fazer alterações sem adicionar código. Além disso, as alterações feitas aplicam-se ao tema pai – permitindo que você faça atualizações com segurança para melhorar a experiência geral do cliente.
Obtenha hospedagem WooCommerce totalmente gerenciada
A API WooCommerce oferece muitos recursos adicionais que podem transformar a forma como você administra seu negócio de comércio eletrônico. Usá-lo corretamente pode melhorar a experiência do cliente, melhorar o desempenho da vitrine e, em última análise, aumentar a lucratividade.
Mas uma ferramenta poderosa como esta API é tão boa quanto a hospedagem em que é executada. Hostinger oferece hospedagem WordPress e WooCommerce poderosa e totalmente gerenciada. Entre em contato com a equipe hoje mesmo e veja como podemos levar o seu negócio – e a experiência de compra do seu cliente – para o próximo nível.
