API v1

Venda MOZ Developers

Crie integrações utilizando as APIs oficiais da Venda MOZ e conecte ferramentas externas às funcionalidades da plataforma.

RESTJSONChaves APIWebhooks

Visão geral

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

url

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

Endpoints públicos do catálogo ficam em /api/public/v1 e não exigem autenticação. Endpoints privados (pedidos, carteira, vendedor, delivery e notificações) exigem uma chave API válida.

Segurança & Autenticação

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.

http

GET /api/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).

API de Produtos

Disponível

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.

GET/api/public/v1/productsLista de produtos activos

GET/api/public/v1/products?slug={slug}Detalhe de um produto

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

bash

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

json

{
  "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"
    }
  ]
}

API de Pedidos

Em breve

Crie e acompanhe pedidos programaticamente. Requer chave API com escopo de pedidos.

POST/api/v1/ordersCriar pedido

GET/api/v1/ordersListar pedidos

GET/api/v1/orders/{order_code}Consultar pedido pelo código (VMZ-000001)

GET/api/v1/orders/{order_code}/statusVer estado do pedido

PATCH/api/v1/orders/{order_code}Atualizar informações do pedido

API de Vendedores

Em breve

Aceda aos dados do vendedor autorizado, estatísticas, produtos cadastrados e histórico de vendas.

GET/api/v1/seller/meDados do vendedor autorizado

GET/api/v1/seller/statsEstatísticas de desempenho

GET/api/v1/seller/productsProdutos cadastrados

GET/api/v1/seller/salesHistórico de vendas

API de Delivery

Em breve

Gestão de entregas, estados, localização e confirmação de entrega.

GET/api/v1/deliveriesEntregas atribuídas

PATCH/api/v1/deliveries/{id}/statusAtualizar estado da entrega

POST/api/v1/deliveries/{id}/locationAtualizar localização

POST/api/v1/deliveries/{id}/confirmConfirmar entrega

API de Pagamentos e Carteira

Em breve

Consulta de saldo, histórico financeiro, comissões e levantamentos.

GET/api/v1/walletSaldo disponível

GET/api/v1/wallet/transactionsHistórico financeiro

GET/api/v1/wallet/commissionsComissões

POST/api/v1/wallet/withdrawalsSolicitar saque

API de Notificações

Em breve

Envie notificações e receba alertas de pedidos, vendas e eventos da plataforma via webhooks.

POST/api/v1/notificationsEnviar notificação

GET/api/v1/eventsEventos da plataforma

POST/api/v1/webhooksRegistar endpoint de webhook

Códigos de erro

As respostas de erro seguem o formato:

json

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

Código	Significado
200	Pedido processado com sucesso.
400	Parâmetros inválidos — verifique o corpo e a query do pedido.
401	Chave API ausente ou inválida.
403	A chave não tem permissão para este recurso.
404	Recurso não encontrado.
429	Limite de utilização excedido — aguarde e tente novamente.
500	Erro interno — tente novamente mais tarde.

Boas práticas

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.