Referência da API

Documentação completa de todos os endpoints disponíveis na API Sonar.

Base URL

https://app.sonar.marketing/api/v1

Endpoints Disponíveis

Clientes

Gerenciar clientes Pessoa Física e Jurídica.

GET /v1/clients — Listar clientes
POST /v1/clients — Criar cliente
GET /v1/clients/:id — Buscar cliente
PUT /v1/clients/:id — Atualizar cliente
DELETE /v1/clients/:id — Desativar cliente

Negócios (Deals)

Gerenciar pipeline comercial.

GET /v1/deals — Listar negócios
POST /v1/deals — Criar negócio
GET /v1/deals/:id — Buscar negócio
PUT /v1/deals/:id — Atualizar negócio
DELETE /v1/deals/:id — Arquivar negócio

Campanhas

Gerenciar campanhas de marketing vinculadas a projetos.

GET /v1/campaigns — Listar campanhas
POST /v1/campaigns — Criar campanha
GET /v1/campaigns/:id — Buscar campanha
PUT /v1/campaigns/:id — Atualizar campanha
DELETE /v1/campaigns/:id — Cancelar campanha

Atividades

Registrar e acompanhar atividades e interações.

GET /v1/activities — Listar atividades
POST /v1/activities — Criar atividade
GET /v1/activities/:id — Buscar atividade
PUT /v1/activities/:id — Atualizar atividade
DELETE /v1/activities/:id — Excluir atividade

Webhooks

Configurar endpoints para receber eventos.

GET /v1/webhooks — Listar webhooks
POST /v1/webhooks — Criar webhook
GET /v1/webhooks/:id — Buscar webhook
PUT /v1/webhooks/:id — Atualizar webhook
DELETE /v1/webhooks/:id — Excluir webhook

Formato das Respostas

Sucesso

{
  "success": true,
  "data": {
    // Dados da resposta
  }
}

Sucesso com Paginação

{
  "success": true,
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "pages": 8
  }
}

Erro

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Campo 'title' é obrigatório"
  }
}

Códigos HTTP

Código	Descrição
`200`	OK — Requisição bem-sucedida
`201`	Created — Recurso criado com sucesso
`400`	Bad Request — Parâmetros inválidos
`401`	Unauthorized — Falha na autenticação
`404`	Not Found — Recurso não encontrado
`422`	Unprocessable Entity — Registro duplicado
`500`	Internal Server Error — Erro interno

Códigos de Erro

Código	Descrição
`UNAUTHORIZED`	Autenticação falhou
`NOT_FOUND`	Recurso não encontrado
`VALIDATION_ERROR`	Erro de validação
`DUPLICATE_ENTRY`	Registro duplicado
`INTERNAL_ERROR`	Erro interno

Autenticação

Todas as requisições requerem autenticação via header Authorization:

Authorization: Bearer snr_live_sua_chave_aqui
Content-Type: application/json

Veja mais em Autenticação.

Paginação

Endpoints que retornam listas suportam paginação:

Parâmetro	Padrão	Máximo	Descrição
`page`	1	—	Número da página
`limit`	20	100	Itens por página

Ordenação

Use o parâmetro sort para ordenar resultados:

# Ordenar por data de criação (mais recente primeiro)
GET /v1/clients?sort=-created_at

# Ordenar por nome (alfabético)
GET /v1/clients?sort=full_name

Prefixo	Direção
(nenhum)	Ascendente (A-Z, 0-9)
`-`	Descendente (Z-A, 9-0)

Datas e Horários

Datas usam formato ISO 8601: YYYY-MM-DD
Timestamps incluem timezone: 2026-02-04T10:30:00Z
Sempre retornamos em UTC

Suporte

Email: suporte@sonar.marketing