# 1 功能描述

支持验证用户姓名、证件号、出生日期、自拍照信息真伪一致性；
支持证件覆盖范围：印尼身份证

# 2 使用说明

# 2.1 调用URL

印尼地址：https://api-idn.yljz.com/finauth/v5/oversea_validation

注意：生产环境必须使用 HTTPS 通信方式；HTTP 属于不安全链路，存在安全风险，禁止在生产环境使用，且不提供服务可靠性保障。

# 2.2 调用方法

请求方式：POST
请求格式：form-data
说明：客户端通过 apikey 和 secret 生成加密签名 sign，同时传入证件相关信息及自拍照，接口返回证件信息核验结果。

# 3 请求参数

参数	参数名	是否必填	类型	说明
sign	签名	是	String	签名生成规则参考鉴权说明
sign_version	签名算法版本号	是	String	固定传值：hmac_sha1
certificate_id	证件类型id	是	String	印尼身份证：ID_ID
biz_no	业务流水号	否	String	自定义本次业务唯一流水号
id_no	国家统一证件号	是	String	印尼传入NIK号
name	用户姓名	是	String	用户完整全名
dob	出生日期	是	String	格式要求：DD-MM-YYYY
selfie	自拍照	是	String	1. Base64编码 2. 图片大小 ≤ 2MB 3. 支持格式：JPG/JPEG/PNG 4. 示例：/9j/7DFKAeSLkgEQABAAD/
validate_auth	身份验证	是	String	固定只能传：true

# 4 返回参数

备注：不同卡证类型仅返回适配字段，非全部返回。

字段	字段名	类型	参数说明
request_id	请求号	String	请求唯一标识；除404、403错误外必返回
time_used	请求耗时	Int	请求整体耗时，单位：毫秒，必返回
biz_no	业务流水号	String	原样返回入参的业务流水号
certificate_id	证件类型id	String	返回客户端传入的证件类型ID
status	验证状态	String	数据整体验真结果： 0：全部数据验证为真。 1：部分数据验证为真。 2：全部数据验证为假。
validate_result	验证结果	JSON	字段级精细化验证结果，返回 true / false
id_no	国家统一证件号	String	证件号单项核验结果
name	用户姓名	String	姓名单项核验结果
dob	出生日期	String	出生日期单项核验结果
selfie	自拍照	String	人脸自拍照单项核验结果
error	错误信息	String	接口异常时返回对应错误码

# 5 ERROR 错误信息对照表

HTTP 状态代码	返回码	是否计费	说明
200	SUCCESS	是	接口调用成功
400	MISSING_ARGUMENTS:	否	缺失必要请求参数
400	BAD_ARGUMENTS:	否	参数解析异常（类型错误、长度超限、图片无法解析等）
404	API_NOT_FOUND	否	调用接口地址不存在
403	AUTHORIZATION_ERROR	否	签名无效
403	AUTHORIZATION_ERROR:	否	api_key被停用、无调用权限、IP未授权、调用量超限 5001：api_key无权限或已停用 5002：未经授权IP（预留） 5007：测试key接口调用量达上限
403	CONCURRENCY_LIMIT_EXCEEDED	否	超出接口并发数限制
500	INTERNAL_ERROR	否	服务器内部错误，可重试；持续异常联系客服

# 6 响应示例

# 6.1 正确请求返回示例（全部验证为真）

text

12345678910111213

{
"request_id": "e6f9c3a5-8d2b-4e4a-9c7f-3b5d9e4c6f7a",
"time_used": 1245,
"biz_no": "202608070004",
"certificate_id": "ID_ID",
"status": "0",
"validate_result": {
  "id_no": true,
  "name": true,
  "dob": true,
  "selfie": true
}
}

# 6.2 正确请求返回示例（部分验证为真）

text

12345678910111213

{
"request_id": "f7a1d4b6-9e3c-4f5b-8d2a-4c6e1a5d7f8b",
"time_used": 1102,
"biz_no": "202608070005",
"certificate_id": "ID_ID",
"status": "1",
"validate_result": {
  "id_no": true,
  "name": false,
  "dob": true,
  "selfie": true
}
}

# 6.3 错误响应示例

text

{
"request_id": "a8b2e5c7-0f4d-4a6c-9e3b-5d7f2b6e8a9c",
"time_used": 98,
"error": "MISSING_ARGUMENTS: name"
}