Skip to main content
A API pública cobre a operação da loja de ponta a ponta. Com um token criado pelo dono, um agente de IA consegue configurar e tocar a loja sem ninguém abrir o painel.

O que dá para fazer

Um roteiro para montar a loja do zero

1

Conheça a loja

GET /api/v1/store mostra os dados atuais, a URL pública e os provedores de pagamento já conectados.
2

Monte o catálogo

Crie as categorias e depois os produtos. Imagens aceitam URL http(s).
3

Ative o pagamento

Conecte um provedor com PUT /api/v1/gateway/{provedor} e aponte o PIX para ele com PUT /api/v1/gateway/PIX.
4

Conecte o domínio

POST /api/v1/domain, crie os registros de dns_records no provedor do domínio, depois verify e primary.
5

Ligue o marketing

Ligue o checkout abandonado, ajuste os emails e crie a primeira campanha.

Onde ainda precisa de uma pessoa

  • Criar o token. É feito no painel, pelo dono ou por um membro autorizado. Veja Permissões do token.
  • Mercado Pago. A conexão é por OAuth: a API devolve a URL de autorização e alguém logado na conta Mercado Pago precisa abri-la.
  • DNS do domínio. A API informa exatamente quais registros criar; criá-los depende de acesso ao provedor do domínio.
  • Credenciais dos provedores. As chaves de cada gateway vêm do painel do próprio provedor.

Regras que valem para o agente

  • Permissões: o token age em nome de quem o criou e só alcança o que essa pessoa pode fazer no painel.
  • Segredos nunca voltam: credenciais de gateway e chaves de plugin aparecem só como “preenchido ou não”. Para mudar uma configuração sem tocar no segredo, basta não reenviá-lo.
  • Tudo fica registrado: cada alteração feita pela API entra no changelog da loja, ligada ao token.
  • Limite de requisições: 120 por minuto por token. Ao receber 429, espere alguns segundos e tente de novo.
  • Emails com cuidado: campanhas saem pela mesma fila e cota do painel e respeitam o descadastro. Use a prévia de público e o email de teste antes de enviar; envio iniciado pode ser interrompido, mas o que já saiu não volta.
  • Erros dizem o que corrigir: validações retornam 400 com message. Templates de email retornam também a linha e a coluna do erro.