Atenção Experts !!
Nosso sistema de API está em desenvolvimento. Em breve iremos liberar a API para todos os usuários.Obrigado por esperar.
API do Expertis
API REST completa para integrar o Expertis com seus sistemas. Acesse e gerencie contatos de forma programática com autenticação segura.
Autenticação Segura
JWT e API Keys com controle de permissões
Gestão de Contatos
CRUD completo para contatos e informações
Performance
Cache Redis e rate limiting integrados
RESTful
Padrões REST com documentação OpenAPI
Como Começar
1. Obter API Key
Primeiro, você precisa de uma API Key. Apenas administradores podem gerar keys.
Base URL: http://localhost:3004
Documentação Interativa: /api-docs
2. Autenticação
Use JWT Bearer token ou API Key no header das requisições.
X-API-Key: <sua-api-key>
Principais Endpoints
/auth/loginAutenticar usuário e obter tokens JWT
/contatosListar todos os contatos do time
/contatosCriar novo contato
/contatos/:idAtualizar contato existente
/contatos/:idRemover contato
Exemplos de Código
// Exemplo de Login
const response = await fetch('http://localhost:3004/auth/login', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: '[email protected]',
password: 'sua-senha'
})
});
const data = await response.json();
console.log('Access Token:', data.accessToken);// Usando API Key
const response = await fetch('http://localhost:3004/contatos', {
method: 'GET',
headers: {
'X-API-Key': 'sua-api-key-aqui',
'Content-Type': 'application/json'
}
});
const contatos = await response.json();
console.log('Contatos:', contatos);// Criar novo contato
const novoContato = {
nomeCompleto: 'João Silva',
email: '[email protected]',
telefone: '(11) 99999-9999',
tipoContato: 'Cliente',
tagsUsuario: ['lead', 'interessado'],
observacao: 'Cliente interessado em apartamento'
};
const response = await fetch('http://localhost:3004/contatos', {
method: 'POST',
headers: {
'Authorization': 'Bearer sua-jwt-token',
'Content-Type': 'application/json'
},
body: JSON.stringify(novoContato)
});
const contato = await response.json();
console.log('Contato criado:', contato);Precisa de Ajuda?
Nossa API é projetada para ser simples e intuitiva. Se você encontrar algum problema ou tiver dúvidas, estamos aqui para ajudar.