Pular para o conteúdo principal
Versão: 1.x

Entendendo a API REST do WooCommerce

A API REST do WooCommerce é como um conjunto de “canais” padronizados que permite que os proprietários de lojas conectem sua loja WooCommerce a outros aplicativos e serviços.

Aqui está uma explicação simples de como funciona:

  1. Ela atua como uma ponte entre sua loja WooCommerce e aplicativos externos, permitindo que eles se comuniquem e compartilhem dados.

  2. A API funciona enviando solicitações para endpoints específicos - pense neles como "canais" para diferentes tipos de dados da loja. Por exemplo, existem endpoints para produtos, pedidos e clientes.

  3. Os aplicativos externos podem usar esses endpoints para:

  • Obter informações (como buscar uma lista de produtos)
  • Adicionar novos dados (como criar um novo pedido)
  • Atualizar informações existentes (como alterar o preço de um produto)
  • Excluir dados (como remover um produto desatualizado)

Em vez de depender de ganchos e filtros PHP (como muitos plugins tradicionais do WordPress fazem), ela funciona enviando e recebendo dados em um formato estruturado e previsível, conhecido como JSON.

SVG not found

Visualizando os Dados JSON no POS

Para ajudar você a entender o que o POS está “vendo”, incluímos uma visualização JSON em várias partes da interface. Por exemplo, quando você edita os metadados do pedido ou um item da linha do carrinho no POS, você verá uma aba JSON (como na captura de tela abaixo).

Editando um item da linha no POS

Visualizando os dados JSON para um item da linha no POS

O navegador também inclui um Inspecionador de Rede, uma ferramenta que permite monitorar os dados sendo enviados e recebidos entre seu navegador e o servidor, incluindo dados JSON.

Inspecionador de Rede no navegador

Inspecionador de Rede no navegador

Por Que Alguns Plugins Não Funcionam no POS?

O WCPOS baixa os dados de produtos, pedidos e clientes da sua loja WooCommerce através da API REST. Ele então mantém uma cópia local desses dados para que possa continuar funcionando mesmo se sua conexão com a internet for instável. Essa abordagem torna o POS mais rápido e confiável em um ambiente de checkout movimentado.

No entanto, isso significa que nosso POS não “vê” as mudanças que acontecem dinamicamente em seu site em tempo real. Por exemplo:

Tipo de PluginPor Que Não Funciona
Precificação Dinâmica

Se outro plugin em sua loja calcular um preço exclusivo para cada cliente logado, o POS não obterá automaticamente esse preço personalizado.

Complementos de Produto

Se outro plugin em sua loja adicionar dados extras de produto, o POS não obterá automaticamente esses dados. O POS apenas obtém os dados que são expostos através da API REST.

Próximos Passos

Para um mergulho técnico mais profundo, confira a documentação oficial da API REST do WooCommerce: https://woocommerce.github.io/woocommerce-rest-api-docs/