Criar pessoa

Cadastre uma nova pessoa com imagens faciais e metadados.

menu_bookReferência da API: criar pessoaexpand_more

Documentação oficial: docs.verifik.co/resources/create-a-person

URL base https://api.verifik.co. Envie JSON com campos de perfil e pelo menos uma imagem facial em base64 por entrada em images (sem prefixo data URL). A documentação pública também lista campos opcionais como notes, email e phone.

POST /v2/face-recognition/persons

Cadastra uma nova pessoa nos ids de coleção informados (valores _id da coleção) com biometria facial para reconhecimento Verifik.

Cabeçalho	Valor
Content-Type	application/json
Authorization	Bearer <token>

Param	Obrig.	Descrição
name	Sim	Nome de exibição
images	Sim	Array de imagens faciais em base64 (base64 puro, não data URLs)
gender	Sim	M ou F (obrigatório nesta demo)
date_of_birth	Sim	YYYY-MM-DD (obrigatório nesta demo)
collections	Sim	Array de strings _id de coleção; esta demo carrega com GET /v2/face-recognition/collections e permite escolher uma ou mais.
nationality	Não	Código ou rótulo de país / nacionalidade opcional

await fetch("https://api.verifik.co/v2/face-recognition/persons", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    name: "Jane Doe",
    gender: "F",
    date_of_birth: "1990-01-15",
    collections: ["<collectionMongoId>"],
    nationality: "CO",
    images: ["<base64>", "<base64>"],
  }),
});

// 200 OK — example shape
{
  "data": {
    "id": "…",
    "name": "Jane Doe",
    "gender": "F",
    "date_of_birth": "1990-01-15",
    "collections": ["…"],
    "…": "…"
  }
}

Esta demo usa createPerson de @humanauthn/api-client com o token da sua sessão.
As respostas podem incluir id e um bloco signature junto de data conforme o ambiente.

menu_book

Guias oficiais em docs.verifik.co

Object

O objeto Person

Campos e estrutura de um registro de pessoa de reconhecimento facial.

GET

Listar todas as pessoas

Pessoas do seu cliente, com filtros opcionais.

GET

Obter uma pessoa

Uma única pessoa por id.

PUT