人证核身服务 IVS-返回结果:响应消息体

时间:2024-11-25 17:13:11

响应消息体

响应消息体通常以结构化格式返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。

对于 人证核身 标准版(三要素)接口,返回如下消息体。

{
    "meta": {
        "uuid": "user_defined"
    },
    "result": {
        "service_name": "ivs-standard",
        "count": 1,
        "resp_data": [
            {
                "verification_result": "valid",
                "verification_message": "Successful certification",
                "verification_code": 1000, 
                "similarity": "88.43",
                "idcard_result": {
                    "name": "张三",
                    "sex": "男",
                    "birth": "2000-03-06",
                    "ethnicity": "汉",
                    "address": "XX省XX市XX区XX街道XX号",
                    "number": "610XXXXXXXXXXXXXXX"
                }
            }
        ]
    }
}

当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。

{
     "error_code": "IVS.0003",
     "error_msg": "Some necessary request parameters in req_data is null."
}

其中,error_code表示错误码,error_msg表示错误描述信息。

support.huaweicloud.com/api-ivs/ivs_02_0012.html