Venda MOZ Developers

A API da Venda MOZ segue o padrão REST e devolve respostas em JSON. Todas as chamadas usam HTTPS e a URL base é:

https://www.venda-mozdrop.site/api

Todos os endpoints ficam em /api/public/v1. O catálogo de produtos é público e não exige autenticação. Os restantes endpoints (pedidos, carteira, vendedor, delivery e notificações) exigem uma chave API válida com as permissões adequadas.

• Chaves API — cada integração recebe uma chave única no formato vmz_live_..., emitida pela equipa Venda MOZ.
• Autenticação — envie a chave no cabeçalho Authorization: Bearer <chave> em cada pedido.
• Tokens — as chaves podem ser revogadas e rotacionadas a qualquer momento sem afetar outras integrações.
• Limites de utilização — cada chave tem limites de pedidos por minuto para garantir a estabilidade da plataforma; respostas excedidas devolvem o código 429.
• Permissões por aplicação — as chaves são limitadas a escopos (ex.: products:read, orders:write, Wallet:read) conforme a necessidade da integração.

GET /api/public/v1/orders HTTP/1.1
Host: www.venda-mozdrop.site
Authorization: Bearer vmz_live_a1b2c3d4e5
Content-Type: application/json

Para solicitar uma chave API, contacte o suporte: +258 87 878 2721 (WhatsApp).

Consulte a lista de produtos, preços, disponibilidade (stock), categorias e imagens do catálogo público da Venda MOZ. Endpoint público — não requer chave API.

Parâmetros: limit (1–100, padrão 24), category (slug da categoria), slug (produto específico).

curl "https://www.venda-mozdrop.site/api/public/v1/products?limit=10"

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "slug": "smartwatch-x9",
      "name": "Smartwatch X9 Pro",
      "price": 2500,
      "currency": "MZN",
      "stock": 14,
      "available": true,
      "is_new": true,
      "niche": "tecnologia",
      "category": "eletronicos",
      "image": "https://.../smartwatch.jpg",
      "short_description": "Relógio inteligente com chamadas e desporto.",
      "url": "https://www.venda-mozdrop.site/p/smartwatch-x9",
      "updated_at": "2026-08-09T00:00:00.000Z"
    }
  ]
}

Crie e acompanhe pedidos programaticamente. Requer chave API com escopo orders:read (consultas) ou orders:write (criar/atualizar).

curl -X POST "https://www.venda-mozdrop.site/api/public/v1/orders" \
  -H "Authorization: Bearer vmz_live_a1b2c3d4e5" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_name": "João Mucavele",
    "customer_phone": "84XXXXXXX",
    "province": "Maputo Cidade",
    "neighborhood": "Baixa",
    "items": [{ "product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "quantity": 1, "unit_price": 2500 }]
  }'

Aceda aos dados do vendedor autorizado, estatísticas, produtos cadastrados e histórico de vendas. Requer escopo seller:read.

Gestão de entregas, estados, localização e confirmação de entrega. Requer escopos deliveries:read e deliveries:write.

Consulta de saldo, histórico financeiro, comissões e levantamentos. Requer escopos wallet:read e wallet:write.

Envie notificações, consulte eventos da plataforma e registe endpoints de webhook. Requer escopos notifications:write, events:read e webhooks:read/write.

As respostas de erro seguem o formato:

{
  "error": {
    "code": "not_found",
    "message": "Produto não encontrado."
  }
}

• Guarde a chave API apenas no servidor — nunca a exponha no código do browser ou em repositórios públicos.
• Faça cache das respostas do catálogo (mínimo 60 segundos) para melhorar a velocidade da sua aplicação.
• Trate os códigos 429 com espera exponencial (retry com backoff).
• Valide sempre as assinaturas dos webhooks antes de processar eventos.
• Use o campo updated_at para sincronizações incrementais de produtos.