IDFace Match Server

Download OpenAPI specification:Download

Info

Information about the server

Responses

Response samples

Content type
application/json
{
  • "version": "string"
}

1:1

Detect faces and create face templates

Detects all faces in an image and generates face templates for each one. You can optionally limit the maximum number of faces with the max-faces parameter. For example you can set it to 1 to only allow single-face images. The image can be in JPEG or PNG formats.

query Parameters
max-faces
integer

Only allow this number of faces in an image. More will generate an error.

templates
boolean
Default: true

Flag to generate face templates or not.

Request Body schema: application/octet-stream
string <binary>

Responses

Response samples

Content type
application/json
{
  • "faces": [
    ]
}

Match face templates

Matches two face templates and returns a probability of them belonging to the same person.

Request Body schema: application/json
source
required
string
target
required
string
calibration
string

Responses

Request samples

Content type
application/json
{
  • "source": "string",
  • "target": "string",
  • "calibration": "string"
}

Response samples

Content type
application/json
{
  • "probability": 0.1
}

1:N

Create face templates collection

Creates new face templates collection in the database.

path Parameters
collection
required
string

Name of the collection.

Responses

Response samples

Content type
application/json
{
  • "error": "string"
}

Get collection information

Returns information about the collection, including a number of total records.

path Parameters
collection
required
string

Name of the collection.

Responses

Response samples

Content type
application/json
{
  • "total_records": 0
}

Delete collection

Delete collection and all its records. By default only deletes collections created by IDFace Match. You can override this behavior with force parameter.

path Parameters
collection
required
string

Name of the collection.

query Parameters
force
boolean
Default: false

Remove any collection.

Responses

Response samples

Content type
application/json
{
  • "total_records": 0
}

Add records to collection

Adds face templates as records into a collection. You can either provide an image or a list of face templates. For the first case all faces on an image will be detected and added to the collection. The image can be in JPEG or PNG formats.

path Parameters
collection
required
string

Name of the collection.

query Parameters
max-faces
integer

Only allow this number of faces in an image. More will generate an error.

Request Body schema:
string <binary>

Responses

Request samples

Content type
No sample

Response samples

Content type
application/json
{
  • "faces": [
    ]
}

Check if record exists

Returns 200 if the record is present in the collection. 404 otherwise.

path Parameters
collection
required
string

Name of the collection.

id
required
string

ID of a face template record to delete.

Responses

Response samples

Content type
application/json
{
  • "error": "string"
}

Delete record

Deletes face template record from the collection.

path Parameters
collection
required
string

Name of the collection.

id
required
string

ID of a face template record to delete.

Responses

Response samples

Content type
application/json
{
  • "error": "string"
}

Search records in collection

Creates face templates for all faces in an image and searches in the collection for similar faces. The image can be in JPEG or PNG formats.

path Parameters
collection
required
string

Name of the collection.

query Parameters
max-faces
integer

Only allow this number of faces in an image. More will generate an error.

limit
integer
Default: 5

Number of matched records to return for every face.

calibration
string

Calibration for the probability.

Request Body schema: application/octet-stream
string <binary>

Responses

Response samples

Content type
application/json
{
  • "faces": [
    ]
}