People API
v1EstávelGestão de pessoas e colaboradores
Visão Geral
Acesse dados de funcionários, colaboradores e visitantes. Vínculos empregatícios, departamentos e histórico.
Documentação
Autenticação
API Key com escopo people:read passada no header X-Api-Key.
Paginação
Suporte a page e limit. Máximo de 100 itens por página.
Filtros
Filtre por department_id, status (active/inactive) e admission_date.
Webhooks
Eventos de admissão, demissão e alteração de vínculo via webhook.
Referência da API
GET
/v1/employeesGET
/v1/employees/{cpf}GET
/v1/departmentsGET
/v1/visitorsPOST
/v1/visitorsexemplo.ts
sandbox
// Buscar colaborador por CPF
const response = await fetch(
'https://api.smartpoint.app.br/v1/employees/000.000.000-00',
{ headers: { 'X-Api-Key': 'SUA_API_KEY' } }
);
const employee = await response.json();
// { cpf, name, department, jobTitle, status, admissionDate }