# 版本

5.0.0

# 描述

此接口用于将客户图像数据进行上传，并获取1:1人脸比对结果。

# 调用URL

新加坡：https://api-sgp.yljz.com/finauth/v5/compare
印尼：https://api-idn.yljz.com/finauth/v5/compare

注意：在生产环境中，请使用HTTPS的通信方式。HTTP方式的通信属于不安全链路，存在安全风险，请勿在生产环境中使用。在生产环境中使用HTTP方式的，将无法得到服务可靠性保障。

# 调用方法

POST  注意：用 form-data 格式请求

# 权限

仅当用户接入FinAuth产品后，才能调用FinAuth各Web API。接入FinAuth的流程请咨询FinAuth商务人员。

# 参数

# 返回值说明

# 返回值示例

正确请求返回示例

{
   "request_id":"1531397565,39b19451-393c-4fc4-8fae-6dc74b2b00d7",
   "biz_no":"",
   "time_used":1448,
   "result_code":1000,
   "result_message":"SUCCESS",
   "verification":{
      "ref1":{
         "confidence":86.63057,
         "thresholds":{
            "1e-3":62.168713,
            "1e-4":69.31534
            "1e-5":74.39926,
            "1e-6":78.038055
         }
      }
   },
   "face":{
      "quality":38.221,
      "quality_threshold":30.1,
      "rect":{
         "left":0.18,
         "top":0.18,
         "width":0.596,
         "height":0.596
       },
      "orientation":90
   },
  "visual_attributes":{
      "age":20,
      "gender":0,
      "age_image_ref1":38,
      "gender_image_ref":0,
   },
  "verify_risk_info":{
      "verify_info_tags":{
         "is_gender_risk":0,
         "is_age_risk":1,
       }
   } 
}

失败请求返回示例

{
    "error": "AUTHORIZATION_ERROR: INVALID_SIGN"
}

# result_code & result_message 对照表

# 错误码列表