全部产品
Search

搜索本产品

    ID Verification：IDN_META

    文档中心

    ID Verification：IDN_META

    更新时间：Jul 06, 2026

    IDN META 是一项用于校验印度尼西亚用户身份信息真实性的服务。该服务通过将客户提供的身份证号、姓名、人脸图像及出生日期与官方数据库进行比对，验证信息的一致性，从而提升用户身份的可信度。

    接口说明

    • 接口名：IdnAuthorityVerifyIntl

    • 请求方法：HTTPS POST

    • 接口说明：调用IdnAuthorityVerifyIntl接口进行印度尼西亚用户身份信息验证服务。

    • QPS限量：API独享QPS限量，详情请参见服务端API QPS限量说明。

    • 服务地址：

      说明

      • 内网访问优势：内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域，请使用内网域名访问 ID Verification 服务，以获得更安全、稳定的通信质量。 

      • 海外访问优化建议：海外网络环境复杂，建议参考服务端网络耗时优化，优化集成方案，降低网络延迟及请求失败概率。

      印度尼西亚

      • 公网：cloudauth-intl.ap-southeast-5.aliyuncs.com

      • 内网：cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

    在线调试和集成

    说明

    在调试和集成前，请确保您已完整阅读使用OpenAPI文档，充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

    您可以在OpenAPI Explorer中直接运行本接口进行调试，并生成本接口的SDK代码示例。

    传入人脸图片格式要求

    • 图片格式：JPG、JPEG、PNG。

    • 图片大小：推荐 50~100 KB，最大不超过 1 MB。

    • 图片分辨率：不超过 1920*1080（高*宽），至少为 640*480（高*宽），推荐短边缩放到 720 像素，压缩率大于 0.9。图片高大于宽，如果传入的照片宽大于高，可能会影响检测效果。

      说明

      图片转 base64 格式后，通常会导致数据体积增加。如需要使用 base64 格式传参，请保证原始图片的体积不超过 0.6 MB，以满足 1 MB 的最大数据传输限制。

    • 图片质量建议：

      • 人脸面部需要完整清晰无遮挡，正对摄像头，推荐上传通过前置摄像头采集的人脸图片。

      • 人脸大小占比图片中面积需要>60%，若人脸较小会影响检测的准确性。

      • 若图片中存在多个人脸，算法默认截取较大的人脸，建议避免传入多个人脸图片。

    请求参数

    名称

    类型

    是否必选

    描述

    示例值

    ProductCode

    String

    是

    接入的产品方案。取值 IDN_META.

    IDN_META

    SceneCode

    String

    否

    用于在控制台查询相关记录的自定义场景ID，由字母、数字和下划线组成，最长10个字符。

    1234567890

    MerchantBizId

    String

    是

    自定义的业务唯一标识，用于后续定位和排查问题。支持长度为 32 位的字母和数字的组合，请确保唯一。

    e0c34a77f5ac40a5aa5e6ed20c35****

    MerchantUserId

    String

    否

    自定义的用户ID，或者其他可以识别特定用户的标识，例如：手机号码、邮箱地址等。强烈建议对该字段的值进行预先脱敏，例如对值进行哈希处理。

    123456789

    idNumber

    String

    是

    身份证（KTP）上的NIK号码。

    birthDate

    String

    是

    身份证（KTP）上的用户出生日期。

    yyyy-mm-dd 格式出生日期

    fullName

    String

    是

    身份证（KTP）上的用户姓名。

    timestamp

    String

    是

    用户同意与官方数据库共享数据的时间戳，请确保传入真实时间戳。

    "consent": {
"consentedAt": "1614089870",
"consentGiven": true
}

    SourceFacePicture

    String

    是，三种上传方式任选其一即可。

    用于人脸识别和比对的照片，需为Base64编码的纯文本字符串，文件大小不超过1MB，格式为JPEG或JPG，建议分辨率480x640。

    base64

    SourceFacePictureUrl

    String

    用于人脸识别和比对的照片地址，公网可访问的HTTP、HTTPS链接。

    https://***

    SourceFacePictureFiles

    InputSteam

    用于比对的人像图片的文件流。

    人像图⽚的InputStream对象

    Mobile

    String

    是

    印度尼西亚手机号码，以+62开头，后跟9至11位数字。请确保真实。

    +6281293671234

    e-Mail

    String

    是

    用户的电子邮箱地址，请确保真实。

    example@gmail.com

    返回数据

    名称

    类型

    描述

    示例值

    HTTP Status Code

    Integer

    HTTP状态码。

    200

    HTTP Body

    RequestId

    String

    请求ID。

    130A2C10-B9EE-4D84-88E3-5384FF0****

    Result.TransactionId

    String

    整个认证流程的唯一标识。

    hksb7ba1b28130d24e015d694361****

    Code

    String

    返回Code，具体信息请参见服务端返回HTTP状态码说明。

    Success

    Message

    String

    返回Code的详细描述。

    Success

    Result.Passed

    String

    认证结果，取值：

    • Y：通过

    • N：不通过

    Y

    Result.SubCode

    String

    认证结果描述。更多信息，请参见ResultObject.SubCode 错误码说明。

    200

    Result.ExtFaceInfo

    Object

    数据源验证结果（以下示例使用印尼数据源）。

    • govId、fullName、dob：得分为1.0表示与官方数据源完全匹配，低于1.0表示不匹配。

    • selfiePhoto：得分高于0.8表示与官方数据源匹配，0.8及以下表示不匹配。

    • liveness：得分高于0.95表示存在活体检测风险。

    • imgManipulationScore：得分高于0.95表示存在图像篡改风险。

    {
  "govId": 1.0,
  "fullName": 1.0,
  "dob": 0.9,
  "selfiePhoto": 0.8777,
  "liveness": 0.1152,
  "imgManipulationScore": 0.2253
}

    ResultObject.SubCode 错误码说明

    错误码

    是否计费

    描述和原因建议

    202

    是

    权威数据源中未找到该身份证号码。

    207

    是

    照片与权威数据源中的信息不匹配。

    209

    否

    权威数据源连接超时。

    214

    是

    个人信息（身份证号码、姓名、出生日期）与权威数据源中的信息不匹配。

    215

    是

    个人信息（身份证号码、姓名、出生日期）和自拍照均与权威数据源中的任何记录不匹配。

    216

    是

    权威数据源检测到活体异常。在与印尼数据源进行验证时，若 ExtScoureInfo 字段中的 liveness 值大于 0.95，或 imgManipulationScore 值大于 0.95，均会触发此异常。

    217

    是

    照片质量不合要求。