🙂Faces

This section is a collection of endpoints related to face detection and recognition operations.

Detect Faces

POST https://api.tagshelf.com/v1/2face/faces/detect

(ASYNC) Detects and returns the amount of faces found in an image file.

Headers

Name	Type	Description
X-Tagshelf-Session*	string	Session Token
User-Agent*	string	User Agent

Request Body

Name	Type	Description
file*	Object	Binary data representing the image file

200: OK Request Succesful

{
    "code": 200,
    "result": 1
}

400: Bad Request Invalid payload

401: Unauthorized Missing API Key

500: Internal Server Error Something went wrong with the service. Please contact support.

403: Forbidden Invalid API Key

Compare Faces

POST https://api.tagshelf.com/v1/2face/faces/detect

(ASYNC) Compares a selfie with a document photo. Receives both images and returns the comparison score as a result.

Headers

Name	Type	Description
X-Tagshelf-Session*	string	Session Token
User-Agent*	string	User Agent

Request Body

Name	Type	Description
document*	Object	Binary data representing the image file
face*	Object	Binary data representing the image file

200: OK Request Succesful

{
    "code": 200,
    "result": 82.7200174331665
}

400: Bad Request Invalid payload

401: Unauthorized Missing API Key

500: Internal Server Error Something went wrong with the service. Please contact support.

403: Forbidden Invalid API Key

Check Smile

POST https://api.tagshelf.com/v1/2face/faces/check-smile

(ASYNC) This endpoint performs smile liveness check on a video clip. If the person in the video is smiling returns true.

Headers

Name	Type	Description
X-Tagshelf-Session*	string	Session Token
User-Agent*	string	User Agent

Request Body

Name	Type	Description
clip*	Object	Binary data representing the video file

200: OK Request Succesful

{
    "code": 200,
    "result": true
}

400: Bad Request Invalid payload

401: Unauthorized Missing API Key

500: Internal Server Error Something went wrong with the service. Please contact support.

403: Forbidden Invalid API Key

Check Blink

POST https://api.tagshelf.com/v1/2face/faces/check-blink

(ASYNC) This endpoint performs blink liveness check on a video clip. If the person in the video is blinking returns true.

Headers

Name	Type	Description
X-Tagshelf-Session*	string	Session Token
User-Agent*	string	User Agent

Request Body

Name	Type	Description
clip*	Object	Binary data representing the video file

200: OK Request Succesful

{
    "code": 200,
    "result": true
}

400: Bad Request Invalid payload

401: Unauthorized Missing API Key

500: Internal Server Error Something went wrong with the service. Please contact support.

403: Forbidden Invalid API Key