# 描述

该接口用于检测海外证件真伪。当前支持证件类型：墨西哥选民证、印尼身份证、菲律宾身份证；支持的伪造检测项包括翻拍检测与人像PS（Photoshop）篡改检测。

# 调用URL

https://api-sgp.yljz.com/finauth/v5/overseas_id_verification

# 调用方法

请求方法：POST
请求参数：content-type: Multipart/Form-Data

参数名称	数据类型	是否必填	说明
sign	string	是	调用此API客户的签名，具体的签名产生方式请查阅 App-鉴权说明
sign_version	string	是	hmac_sha1
image	file	是	一个图像，二进制文件，需使用 Multipart/Form-Data 的方式上传。注：要求文件大小小于 10MB，支持最小分辨率 200×200，最大 8000×8000。

# 返回值

content-type：application/json

参数名称	数据类型	说明	示例值
request_id	string	用于区分每一次请求的唯一的字符串。除非发生404（API_NOT_FOUND）或 403 （AUTHORIZATION_ERROR）错误，此字段必定返回
time_used	int	整个请求所花费的时间，单位为毫秒，除非发生404（API_NOT_FOUND）或 403 （AUTHORIZATION_ERROR）错误，此字段必定返回
forge_data	json object	包含伪造检测的完整结果数据，具体包括： 1.最终判定结果（是否为伪造） 2.各类可能的伪造类型及其对应置信度（用于辅助说明判定依据）	见下方示例
error	string	发生错误后，会返回对应的错误码，具体见下面 ERROR 错误信息

# forge_data结构

字段名称	数据类型	说明	示例值
is_forged	boolean	是否为伪造证件（true为伪造，false为正常）	true
attack_info	json object	伪造检测详细结果包含命中伪造类型（0：未命中，1：命中） screen：翻拍；PS：人像PS

# forge_data参数示例

{
  "is_forged":true,
  "attack_info":{
    "screen":1,
    "PS": 1
  }
}

# 返回示例

{
  "request_id": "1751535373,27967427-41ea-41e9-83ab-e8fa5f688b21",
  "time_used": 255,
  "forge_data": {
    "is_forged": false,
    "attack_info": {
      "screen": 0,
      "PS": 0
    }
  }
}

# 错误信息

错误信息	说明	解决方案
IMAGE_ERROR_UNSUPPORTED_FORMAT	图片解码失败
INVALID_IMAGE_SIZE:	图片尺寸过大或过小
INTERNAL_ERROR	服务器内部错误	稍后重试或联系技术支持