人脸比对API

人脸比对 API 是用于验证用户照片信息是否一致。

API 方式

Base URL

印尼节点：https://id.apitd.net/verification/kyc/identity/v1
巴基斯坦节点：https://pk.apitd.net/verification/kyc/identity/v1

API

URL	请求方式	Content-Type	输出格式	字符集
api-base-url?partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

认证参数

字段	类型	含义	建议	备注
partner_code	String	合作方标识	必须	由 TD 分配
partner_key	String	合作方密钥	必须	由 TD 分配

请求参数

字段	类型	含义	建议	备注
face_image	String	人脸照片	必须	JPG、JPEG格式人脸或活体照片的base64(NO WRAP)，3M以内
id_image	String	身份证件人脸页照	必须	JPG、JPEG格式含人脸证件照的base64(NO WRAP)，3M以内
country	String	国家码	必须	2位ISO国家码 (ISO 3166 标准)

响应参数

字段	类型	含义	备注
result	String	人脸比对结果	枚举值：pass、fail
similarity	Double	人脸对比的相似度百分比	0~100，默认≥75为同一人

API状态码

Code	Message	是否计费
200	Success	是
12404	Face has not been detected	是
12405	Image feature extraction processing failed	否
11301	{parameter} empty	否
11304	The country partner located is not open	否
11340	{parameter} error	否
11350	Internal error	否
301	Service not purchased	否
302	Service has been suspend	否
303	Not enough balance	否
304	Service expired	否
305	Daily maximum volume reached	否

响应示例

业务请求成功

{
"code": 200,
"result": "pass",
"sequence_id": "c7920f4a23264ed0a376f8647e14e34b",
"similarity": 89.7134
}

业务请求失败

{
"code": 11304,
"message": "The country partner located is not open.",
"sequence_id": "d2b38289a10f48d487ee7317260078c0"
}