Luno API — Visão Geral
Integre seu sistema ao Luno CRM usando a API de integração com autenticação por token estático e permissões granulares.
A Luno API permite que sistemas externos consumam dados do Luno CRM de forma segura, utilizando um token de integração com permissões granulares.
Como funciona
Cada token de integração é criado pelo administrador da conta diretamente no painel do Luno CRM, em Configurações → Integrações → Luno API. O token define quais contextos da API o sistema externo pode acessar.
Sistema Externo ──── Bearer {seu-token} ───► Luno APIPermissões disponíveis
Ao criar um token, o administrador seleciona quais contextos o token pode acessar:
| Permissão | O que libera |
|---|---|
PROPERTY | Imóveis, cidades, status, padrão e subcategorias |
ENTERPRISE | Empreendimentos e unidades por localização |
COMPANY | Dados da empresa |
USER | Corretores e usuários |
LEAD | Envio de leads |
EVENT | Registro de eventos |
Ciclo de vida do token
CRIADO (ativo)
│
├── expiresAt ultrapassado → EXPIRADO
│
└── desativado via painel → DESATIVADO
│
└── deletado via painel → DELETADO (soft delete)Para trocar o token de um sistema em produção: crie um novo token no painel, atualize o sistema externo com o novo valor e então delete o token antigo.
Base URL
https://api.seudominio.comTodas as rotas da API de integração utilizam o prefixo /v2/api.