Call this API to generate an signatureId.

Request Example:

curl -X POST  
-H "X-ACCESS-TOKEN: `{Your Access Token}`" \
"https://api.advance.ai/liveness/ext/v1/generate-signature-id" \
-d '{"productLevel":"STANDARD", "livenessType":"DISTANT_NEAR"}'

Request URL

Regional Liveness Detection

https://api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

https://my-api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

https://th-api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

https://ph-api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

https://mex-api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

https://col-api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

https://nga-api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

Global Liveness Detection

https://sg-api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

https://api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

https://th-api.advance.ai/liveness/ext/v1/generate-signature-id
POST (application/json)

Request Header Parameters

Parameter	Description
X-ACCESS-TOKEN	`string` Please use Token Authentication API to get your access token

RequestBody

Parameter	Description
productLevel	`string`[Optional] the productLevel that satisfy the client's business needs. Refer to ProductLevel. Note: This parameter only needs to inputed when you use Advanguard Liveness Detection Standard or Advanguard Liveness Detection Pro.
livenessType	`string` [Optional] default to `DISTANT_NEAR`. Determine how the user go through the liveness capture. Refer to Liveness Type List

Parameter

Description

productLevel

string[Optional] the productLevel that satisfy the client's business needs. Refer to ProductLevel.

Note: This parameter only needs to inputed when you use Advanguard Liveness Detection Standard or Advanguard Liveness Detection Pro.

livenessType

string [Optional] default to DISTANT_NEAR. Determine how the user go through the liveness capture. Refer to

Liveness Type List

ProductLevel

The productLevel defines the tier of the Identity Verification(..DV, LD, FA) service. Please consult with our sales representative to determine the tier that best aligns with your business requirements and use the granted product level for your API request submission.

Supported Values	Description
STANDARD	Basic compliance / High passrate / Acceptable accuracy
PRO	Strong compliance / Enhanced accuracy

Response Description

Parameter	Description
code	Liveness Detection Status Code
transactionId	The request id, the max length is 64
pricingStrategy	Whether the request will be charged, enum type: FREE, PAY
message	Status Code Explanation
data	`signatureId` signatureId for this liveness detection
extra	Extra response info (Exception Message)

Response Code

Status Code	Message
SUCCESS	OK
PARAMETER_ERROR	Parameter error, please check you input.
	Parameter should not be empty
ERROR	Server error

Response Examples

{
    "code": "SUCCESS",
    "message": "OK",
    "data": {
        "signatureId": "xxxxxxx"
    },
    "extra": null,
    "transactionId": "ac66706068e737b5",
    "pricingStrategy": "FREE"
}