Face liveness

Supports response signature.

Face liveness

post

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

Query parameters

shouldSignResponsebooleanoptional

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

imageUrlstringoptional

URL of the image to be tested.

personobjectoptional

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 '{
    "imageUrl": "text",
    "person": {
      "cpf": "text",
      "name": "text"
    }
  }'

200

400

401

405

500

200

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

Success