Search Face Image [multipart/form-data]

POST/process-image/biometrics/database/search-face-image

[updatedIn] 6 months ago

Request

[message.headerParameter]

Authorization

string

required

Token de autorização obtido no método user/authenticate.

Example:

Bearer {{bearer_token}}

[message.bodyParameter]multipart/form-data

file

required

Binário do arquivo de imagem que contenha faces.

database

string

required

Nome do banco de dados de faces

Request samples

[api.label.responses]

OK(200)

HTTP Code: 200

Content Type : JSONapplication/json

result

array [object {2}]

required

Lista contendo o resultado do método (consulte na documentação específica de cada um).

faceId

string

required

ID da face mais similar encontrada

similarity

number <float>

required

Score de similaridade entre a face de maior área da imagem enviada e a face mais similar encontrada no banco de dados de faces. É normalizado no intervalo de 0.0 (menor score) à 1.0 (maior score). Quanto maior este valor maior é a similaridade.

>= 0<= 1

requestId

string

required

Código único de identificação da solicitação ao servidor, que será registrado no histórico de consumo dos serviços.

elapsedMilliseconds

integer

required

Tempo de duração do processamento em milissegundos.

status

object

required

Objeto contendo o código de status e a mensagem de resposta.

message

string | null

required

Mensagem de retorno de status. Veja os valores possíveis nas mensagens de erro do mostQI.

code

string

required

Código de status interno. Veja os valores possíveis nas mensagens de erro do mostQI.

errors

array [object {2}] | null

required

{
  "result": [
    {
      "faceId": "f1640495-0a60-4bba-b211-4f2e4029b90a",
      "similarity": 0.67
    }
  ],
  "requestId": "Qw5SbuZ67gm4voMhsTwcA",
  "elapsedMilliseconds": 299,
  "status": {
    "message": "Ok",
    "code": "200",
    "errors": null
  }
}

[updatedIn] 6 months ago