返回结果

状态码

请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。

状态码是一组数字代码，状态码表示了请求响应的状态，如果调用后返回状态码为2xx，则表示调用成功。完整的状态码列表请参见状态码。

响应消息头

对应请求消息头，响应同样也有消息头，如“Content-type”。例如表1所示。

响应消息体

响应消息体通常以结构化格式返回，与响应消息头中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表示错误描述信息。