Access API

v1Estável

Controle de acesso físico e permissões

Visão Geral

Gerencie o acesso a catracas, portas e áreas restritas. Perfis de acesso, histórico de passagens e permissões por horário.

Documentação

Autenticação

API Key com escopo access:read e access:write passada no header X-Api-Key.

Perfis

Defina permissões por área, horário e dia da semana.

Validação

POST /validate retorna allow/deny em < 100ms para catracas e portas.

Webhooks

Eventos de passagem, negativa e alarme enviados via webhook.

Referência da API

GET/v1/access-logs
GET/v1/access-profiles
POST/v1/access-profiles
GET/v1/areas
POST/v1/access/validate
exemplo.ts
sandbox
// Validar acesso
const response = await fetch(
  'https://api.smartpoint.app.br/v1/access/validate',
  {
    method: 'POST',
    headers: { 'X-Api-Key': 'SUA_API_KEY', 'Content-Type': 'application/json' },
    body: JSON.stringify({ cpf: '000.000.000-00', deviceId: 'catraca-01' }),
  }
);
const { allowed, reason } = await response.json();