# 版本

3.0.0

# 描述

此接口用于将FaceID MegLiveStill SDK 所获得的数据进行上传，并获取活体验证、人脸比对、攻击防范等结果信息。

注意：本接口仅支持FaceID MegLiveStill SDK 3.0及以上版本的数据

# 调用URL

新加坡：https://api-sgp.megvii.com/faceid/v3/sdk/verify
印尼：https://api-idn.megvii.com/faceid/v3/sdk/verify

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

# 调用方法

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

# 权限

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

# 参数

# 返回值说明

# 返回值示例

正确请求返回示例

{
   "time_used":1448,
   "verification":{
      "ref1":{
         "confidence":86.63057,
         "thresholds":{
            "1e-3":51.244865,
            "1e-5":75.758,
            "1e-4":58.77636,
            "1e-6":79.041
         }
      }
   },
   "attack_result":{
      "score":0.26,
      "threshold":0.5,
      "result":False
   },
   "risk_info":{ 
      "device_info_level": "2", 
      "device_info_tags": {"is_root":0,"is_hook":1,"is_injection":1,"is_virtual_environment":1}
   },
   "request_id":"1531397565,39b19451-393c-4fc4-8fae-6dc74b2b00d7",
   "images":{
      "image_best":"xxxxxxxxxxx"
   },
   "biz_no":"",
   "result_message":"SUCCESS",
   "result_code":1000
}

失败请求返回示例

{
    "error": "AUTHORIZATION_ERROR: INVALID_SIGN"
}

# result_code & result_message 对照表

# 错误码列表