提交信息模板实名认证_信息模板接口_API 参考（推荐版）

提交信息模板实名认证。提交实名认证时需要上传采用Base64编码的实名认证资料图片，并要求原图片为jpg或者bmp格式，原图片大小限制为55K-1M。

	说明
	该接口必须采用POST方式调用，否则调用将会失败，使用SDK调用时，请设置request对象的method参数为POST。

请求参数

公共请求参数，详见公共参数。

名称

类型

是否必须

描述

Action

String

是

操作接口名，系统规定参数，取值：RegistrantProfileRealNameVerification。

RegistrantProfileID

Long

是

信息模板编号。

IdentityCredentialNo

String

是

实名认证资料证件号码，如：身份证号码、统一社会信用代码。

IdentityCredentialType

String

是

实名认证证件类型，取值：

SFZ：身份证
HZ：护照
YYZZ：营业执照
ORG：组织机构代码证
XYDM：统一社会信用代码证书
TXZ：港澳居民来往内地通行证

如果您使用的证件不在上述范围中，请参考支持实名认证的证件类型查看相应的证件类型取值。

	说明
	请务必选择与您传入的证件相符的证件类型。

IdentityCredential

String

是

使用Base64编码的实名认证资料图片。要求图片为jpg或者bmp格式，原图片大小限制为55K-1M。

返回参数


名称	类型	描述
RequestId	String	唯一请求识别码。

错误码


错误代码	描述	HTTP状态码	语义
ParameterIllegal	Parameter illegal.	400	参数错误。
NetworkIOError	Network IO Error.	400	网络I/O异常。
FileDataError	File data error.	400	上传的文件数据错误。
FileFormatNotSupported	The file format is not supported.	400	上传的文件格式不支持。
FileSizeLessThanMinLimit	The file size is smaller than the minimum limit.	400	上传的文件大小小于最小值限制。
FileSizeGreaterThanMaxLimit	The file size exceeds the maximum limit.	400	上传的文件大小大于最大值限制。
ContactTemplateNotExist	Contacts template does not exist.	400	联系人模板不存在。
ContactTemplateAudited	The current information template has a status of real-name authentication complete or under review, so you cannot submit real-name authentication materials.	400	当前信息模板状态为已实名认证或审核中，不允许提交实名认证资料。
ContactTemplateUpdateFailed	Failed to save template information.	400	模板资料保存失败。

示例

请求示例

请求是由POST的方式调用，以下将以Java SDK为示例：

import org.apache.commons.codec.binary.Base64; 
import com.aliyuncs.domain.model.v20180129.RegistrantProfileRealNameVerificationRequest;
import com.aliyuncs.domain.model.v20180129.RegistrantProfileRealNameVerificationResponse;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.profile.IClientProfile;
import com.aliyuncs.DefaultAcsClient; 
public class RegistrantProfileRealNameVerificationDemo {
     private static IAcsClient client = null;
     //初始化client
     static {
         String regionId = "cn-hangzhou"; //必填固定值，必须为“cn-hanghou”
         String accessKeyId = ""; // your accessKey
         String accessKeySecret = "";// your accessSecret
         IClientProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
         client = new DefaultAcsClient(profile);
         }
     public static void main(String[] args) {
        //请自行读取文件获取图片的字节数组
        byte[] img = null;
        //将图片进行Base64编码
          String base64Img = Base64.encodeBase64String(img);
          //初始化请求
        RegistrantProfileRealNameVerificationRequest request = new RegistrantProfileRealNameVerificationRequest();
          //指定请求方法
        request.setMethod(MethodType.POST); 
        request.setRegistrantProfileID(000000L);
        request.setIdentityCredentialNo("000000000000000000");
        request.setIdentityCredentialType("SFZ");
        request.setCredential(base64Img);
         //发起api调用并解析结果
         try {
              //调用失败会抛出异常
             RegistrantProfileRealNameVerificationResponse response = client.getAcsResponse(request);
             System.out.println(response.getRequestId()）
         } catch (ServerException e) {
             e.printStackTrace();
         } catch (ClientException e) {
             e.printStackTrace();
         }
     }
 }

返回示例

XML示例

<?xml version='1.0' encoding='UTF-8'?>
<RegistrantProfileRealNameVerificationResponse>
    <RequestId>51D584A2-0CCD-4336-AD7D-1AD4C67B5545</RequestId>
</RegistrantProfileRealNameVerificationResponse>

JSON示例

{
  "RequestId": "51D584A2-0CCD-4336-AD7D-1AD4C67B5545"
}