API de Pessoa

A API de Pessoa permite gerenciar o cadastro de pessoas no sistema Accessus. Pessoas são entidades fundamentais que podem ser associadas a acessos.

Visão Geral

Método	Endpoint	Descrição
POST	/persons	Criar nova pessoa

Base URL

Todos os endpoints utilizam o prefixo: /accessus/api/v1

---

Cadastro

Criar Pessoa

Cadastra uma nova pessoa no sistema.

POST/accessus/api/v1/persons

Autenticação

Requisito	Valor
Autenticação	Obrigatória
Permissão	PERM_API_WRITE_PERSON
Content-Type	application/json

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
name	string	✓	Nome da pessoa
familyName	string	✓	Sobrenome da pessoa
gender	number	✓	Sexo: 0 = Masculino, 1 = Feminino
documentType	object	✓	Tipo do documento (deve existir no sistema)
documentType.name	string	✓	Nome do tipo de documento (ex: CPF)
documentNumber	string	-	Número do documento
birthDate	string	-	Data de nascimento (formato: YYYY-MM-DD)
email	string	-	E-mail da pessoa
phoneNumber	string	-	Telefone de contato
place	string	-	Local/sala
garage	string	-	Vaga de garagem
companyName	string	-	Nome da empresa
registrationNumber	string	-	Número de matrícula
observation	string	-	Observações adicionais
contractType	object	-	Tipo de contrato
unity	object	-	Unidade

Exemplo de Requisição:

{
  "name": "João",
  "familyName": "da Silva",
  "birthDate": "2024-04-11",
  "place": "Sala 1",
  "garage": "G1 - 9",
  "documentType": { 
    "name": "CPF" 
  },
  "documentNumber": "11122233344",
  "gender": 0,
  "phoneNumber": "48999999292",
  "email": "joao@toptic.com.br",
  "observation": "n/a",
  "companyName": "TOPTIC TECHNOLOGY",
  "registrationNumber": "12345678",
  "contractType" : { "id": 1 },
  "unity" : { "id": 1 }
}

Respostas

✅ 201 CREATED - Pessoa criada com sucesso

{
  "id": 7,
  "name": "João",
  "familyName": "da Silva",
  "birthDate": "2024-04-11",
  "place": "Sala 1",
  "garage": "G1 - 9",
  "documentType": { 
    "name": "CPF" 
  },
  "documentNumber": "11122233344",
  "gender": 0,
  "phoneNumber": "48999999292",
  "email": "joao@toptic.com.br",
  "observation": "n/a",
  "companyName": "TOPTIC TECHNOLOGY"
}

❌ 400 BAD REQUEST - Campos obrigatórios não enviados

{
  "status": 400,
  "message": "Alguns campos obrigatórios não enviados.",
  "path": "/accessus/api/v1/persons/"
}

❌ 400 BAD REQUEST - Tipo de documento inválido

{
  "status": 400,
  "message": "Tipo de documento não existe: XYZ",
  "path": "/accessus/api/v1/persons/"
}

❌ 400 BAD REQUEST - Documento já existente

{
  "status": 400,
  "message": "O nº documento 11122233344 já existe na base de dados.",
  "path": "/accessus/api/v1/persons/"
}

---

Permissões

Para habilitar as permissões necessárias para utilizar esta API, acesse: Atribuir Permissões ao Papel

Permissão	Descrição
PERM_API_WRITE_PERSON	Permite criar e editar pessoas

Atenção

Após habilitar uma permissão no menu Papel, realize o logout do sistema e reinicie a aplicação para que as alterações tenham efeito.