API Reference
ViaWB REST API
Base URL: https://api.viawb.com.br/v1
Autenticação
Todas as requisições à API ViaWB requerem autenticação via Bearer token no header Authorization. Gere suas chaves no dashboard em MCP Keys → Nova chave.
Header de autenticação
Authorization: Bearer vwb_sk_live_xxxxxxxxxxxxxxxxxxxx
curl
curl https://api.viawb.com.br/v1/mcp/tools/list \
-H "Authorization: Bearer vwb_sk_live_xxx"
MCP Gateway
Endpoints para listar ferramentas disponíveis e executar chamadas MCP através do gateway com permissões aplicadas.
GET/mcp/tools/listLista ferramentas disponíveis
POST/mcp/tools/callExecuta uma ferramenta MCP
Audit & Logs
Acesse o log imutável de auditoria de todas as chamadas realizadas pelo gateway. Suporta paginação, filtros por agente, período e status de permissão.
GET/audit/logsLista entradas do log de auditoria
GET/audit/logs/{id}Detalha uma entrada de log
Keys
Gerencie chaves de acesso MCP — criação, listagem e revogação.
POST/keysCria uma nova chave de acesso
GET/keysLista chaves de acesso
DELETE/keys/{id}Revoga uma chave de acesso
Integrações
Gerencie e teste as integrações de ERP configuradas na sua conta.
GET/integrationsLista integrações configuradas
POST/integrations/{id}/testTesta conectividade de uma integração
Códigos de erro
A API ViaWB usa códigos HTTP padrão e retorna um objeto de erro com código e mensagem legível.
Formato de erro
{
"error": {
"code": "permission_denied",
"message": "Role reader-comercial lacks DELETE scope on /pedidos",
"request_id": "req_01j9xkp..."
}
}
| HTTP | Código | Descrição |
|---|---|---|
| 401 | unauthorized | Chave de acesso inválida ou ausente |
| 403 | permission_denied | Papel não possui escopo para a operação solicitada |
| 404 | not_found | Recurso não encontrado |
| 422 | validation_error | Parâmetros da requisição inválidos |
| 429 | rate_limited | Limite de requisições atingido para o papel configurado |
| 503 | upstream_unavailable | ERP configurado não respondeu no timeout |