Face liveness

Supports response signature.

Face liveness

It checks whether the uploaded photo is authentic, detecting if it is not a photo or video.

post

/faces/liveness

Query parameters

shouldSignResponseboolean

Specifies whether the request should be signed. The default is false. e.g. shouldSignResponse=true.

Header parameters

Authorizationstringrequired

Your access token. See more in the 'Authentication' topic of this section.

Body

imageUrlstring

URL of the image to be tested.

personobject

The purpose of these fields is to identify the user and avoid possible replay attacks.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.mobile.combateafraude.com/faces/liveness' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{"person":{}}'

200

400

401

405

500

200

{
  "requestId": "2b8f373-c462-4bbf-9a4f-8aeb7d71ec53",
  "isAlive": true,
  "attemptId": "6021a21b3811c35ecb8dea20",
  "message": null,
  "person": {
    "cpf": "00011122233",
    "name": "John Doe"
  }
}

Success