Buscar usuário

Realiza uma busca de Reconhecimento Facial 1:N dentro da coleção. Retorna os usuários que correspondem e que atendem ao limiar de similaridade configurado.

Endpoint

POST /users/search

Autenticação

Tipo	Localização	Nome
API Key	Cabeçalho	x-api-key

Corpo da solicitação

Content-Type: application/json

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
face	string	Sim	Imagem do rosto do usuário codificada em Base64 ou tokenizada. Para imagens abertas, os formatos suportados são JPEG e PNG. Tamanho máximo suportado: 5MB.
threshold	number	Não	Valor que especifica a confiança mínima na coincidência facial para retornar um resultado. O valor padrão é 80%.

Exemplo de solicitação

{
  "face": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "threshold": 75.5
}

Respostas

200 Sucesso

Parâmetros de resposta

Parâmetro	Tipo	Descrição
matches	array	Array de usuários correspondentes ordenados por pontuação de similaridade do maior para o menor.
matches[].userId	string	Identificador único do usuário correspondente.
matches[].similarity	number	Pontuação de similaridade entre 0 e 100, indicando a confiança da correspondência.

Exemplo de resposta

{
  "matches": [
    {
      "userId": "f7eab18f-e5d3-4dac-9d4d-cfb969ef848e",
      "similarity": 99.99953
    }
  ]
}

400 Requisição inválida

{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}

401 Não autorizado

{
  "message": "Unauthorized"
}

403 Acesso negado

{
  "Message": "User is not authorized to access this resource with an explicit deny"
}

404 Não encontrado

{
  "status": 404,
  "title": "Not Found",
  "detail": "O servidor não consegue encontrar o recurso solicitado.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"
}