Painel
Menu da documentação
Zolvi APIv1 estável

zolvibot.app/api/v1

40 rotas · REST e webhooks

Documentação

API e webhooks da Zolvi

Ligue a sua loja do Discord a qualquer sistema: leia e mude pedidos, produtos, estoque, cupons e afiliados pela API, e receba um aviso assinado no seu servidor quando algo acontece na loja.

Rotas da API
40
em 9 grupos
Eventos de webhook
12
assinados com HMAC
Permissões
33
por chave, como na equipe
Formato
JSON
centavos e datas em UTC

Começo rápido

  1. 1

    Crie a chave

    No painel, em Integrações › Chaves de API, clique em Nova chave e escolha as permissões. A chave (zv_sk_…) aparece uma vez só.

  2. 2

    Mande no cabeçalho

    Em cada chamada, Authorization: Bearer zv_sk_… para /api/v1.

  3. 3

    Leia a resposta

    Sempre JSON: dinheiro em centavos, datas em ISO 8601 (UTC) e listas com paginação.

curl
curl https://zolvibot.app/api/v1/store \
  -H "Authorization: Bearer zv_sk_SUA_CHAVE"
A chave fica no seu servidor. Nunca coloque a chave no navegador, num app ou num repositório público: quem tem a chave mexe na loja dentro das permissões dela.

O que dá para fazer

Loja1Os dados da loja dona da chave.Ver as rotasPedidos3Pedidos que geraram Pix (carrinhos sem Pix não aparecem).Ver as rotasProdutos e opções8Cada produto tem uma ou mais opções (ex.: 7D, 30D), cada uma com preço e estoque próprios.Ver as rotasEstoque5Os itens únicos de cada opção (keys, contas, links): cada um é entregue para um comprador só.Ver as rotasClientes2Quem já abriu um carrinho na loja, com quanto gastou e quantos pedidos pagou..Ver as rotasAvaliações1As notas (1 a 5 estrelas) e comentários que os clientes deram na DM de entrega..Ver as rotasCupons5Códigos de desconto que o cliente usa no carrinho.Ver as rotasAfiliados7Código de apoiador, como nos jogos: o cliente digita o código de um criador no carrinho ou com /apoiar, e cada compra paga dá comissão a ele.Ver as rotasWebhooks8Gerencie os webhooks da loja pela API (até 10).Ver as rotas
Criar a primeira chamadaReceber eventos

Convenções

  • Base: https://zolvibot.app/api/v1. Corpo das requisições em JSON (Content-Type: application/json).
  • Campos em snake_case. Dinheiro em centavos, inteiro (total_cents: 2990 = R$ 29,90).
  • Datas em ISO 8601 (UTC). Nos filtros, aceitamos só a data (2026-11-01) ou data e hora com fuso.
  • No PATCH, mude só o que enviar; null limpa um campo opcional.
  • Listas vêm em { data, meta }: veja Paginação.
  • Tudo o que a API muda aparece no Registro do painel como API: nome da chave.