API REST e chaves de API (integrações)
Integre o CRM com outros sistemas via API REST, autenticada por chave.
O Sellio expõe uma API REST para você ler e gravar registros a partir de outros sistemas (Zapier, Make, scripts próprios, etc.). O acesso é autenticado por uma chave de API que você gera em Configurações → API e chaves.
Gerar uma chave
- Vá em Configurações → API e chaves.
- Dê um nome (ex.: "Integração Zapier") e clique em "Gerar chave".
- Copie a chave NA HORA: ela aparece uma única vez e não é recuperável depois.
- Para desligar uma integração, use "Revogar": a chave para de funcionar imediatamente.
Endpoints
- GET /api/v1/{objeto}: lista registros (parâmetros: limit, offset, search).
- GET /api/v1/{objeto}/{id}: um registro.
- POST /api/v1/{objeto}: cria um registro (corpo JSON com os campos).
- PATCH /api/v1/{objeto}/{id}: atualiza campos de um registro.
Envie a chave no cabeçalho Authorization: Bearer sk_live_… O {objeto} é o Nome de API do objeto (contact, company, lead, opportunity ou um objeto seu).
Rate limit e uso (SLA)
Cada chave tem um limite de requisições por minuto (padrão 120), ajustável na própria lista de chaves. Toda resposta traz os cabeçalhos X-RateLimit-Limit (o teto), X-RateLimit-Remaining (quantas ainda cabem na janela atual) e X-RateLimit-Reset (o instante, em epoch, em que a janela reinicia).
Ao ultrapassar o limite, a API responde 429 (Too Many Requests) com o cabeçalho Retry-After indicando em quantos segundos tentar de novo. A tela de chaves também mostra o total de requisições já feitas por cada chave (métrica de uso).