Face Search

Notes : Please first check the Glossary for basic information about ADVANCE API.

Face Search Get Result(API)

Call this API to generate an Identity Verification Solution (H5) link.

Request Example:

curl -X POST \
  https://ph-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/face-search \
  -H 'Content-Type: application/json' \
  -H 'X-ACCESS-TOKEN:{Your Access Token}' \
  -d '{
"signatureId": "730baa5ab2e34e53"
}'

Request Url

https://my-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/face-search
POST (application/json)

https://ph-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/generate-url
POST (application/json)

https://th-api.advance.ai/intl/openapi/identity-risk/idvs-h5/ekyc/v1/generate-url
POST (application/json)

Notes:

If your test/official environment is in China, please request the service via VPN to avoid packet loss, service timeout and other problems

Request Header Parameters

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

Request Parameters

Parameter	Description
signatureId	`string` which can use it to get the H5 IDV result

Response Description

Parameter	Description
code	H5 Document Verification Status Code
transactionId	The request id, the max length is 64
pricingStrategy	`Deprecated`, Always return `FREE`
message	Status Code Explanation
data	`signatureId` signatureId which can use it to get the H5 IDV result
	`simliarFaceUserIds` hited faceId list(userId inputed in the generateUrl process)
extra	Extra response info (Exception Message)

Response Code

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

Response Examples

SUCCESS Response

{
    "code": "SUCCESS",
    "message": "OK",
    "data": {
        "signatureId": "ed8b21c0c87ad617",
        "simliarFaceUserIds":["2fe2cff789245240","406d5049c4db9723"]
    },
    "extra": null,
    "transactionId": "ed8b21c0c87ad617",
    "pricingStrategy": "FREE"
}

#### PARAMETER_ERROR Response

{
    "code":"PARAMETER_ERROR",
    "message":"Parameter error,please check you input.",
    "data":null,
    "extra":null,
    "transactionId":"ba134d6112c57a4c",
    "pricingStrategy":"FREE"
}

{
    "code":"PARAMETER_ERROR",
    "message":"Parameter should not be empty",
    "data":null,
    "extra":null,
    "transactionId":"dfcdc346a81f404f",
    "pricingStrategy":"FREE"
}

ERROR Response

{
    "code":"ERROR",
    "message":"Server error",
    "data":null,
    "extra":null,
    "transactionId":"1deae5a13ef2bd5e",
    "pricingStrategy":"FREE"
}