华为云用户手册

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

申请服务 正式使用服务之前，必须先申请开通服务，下面是相关服务申请的步骤。 首次使用服务时，需要先申请开通该服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示IVS.0015报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。 登录人证核身服务控制台。 选择需要使用的服务，在操作列单击“开通服务”。 图1 开通服务 服务开通成功后，开通状态显示“已开通”。 父主题： 如何调用API

响应示例 状态码： 200 OK { "meta" : { "uuid" : "user_defined" }, "result" : { "service_name" : "ivs-idcard-extention", "count" : 1, "resp_data" : [ { "verification_result" : "valid", "verification_message" : "Successful certification", "verification_code" : 1000, "idcard_result" : { "name" : "张三", "sex" : "男", "birth" : "2000-03-06", "ethnicity" : "汉", "address" : "XX省XX市XX区XX街道XX号", "number" : "44***********07", "issue" : "XX省XX市XX区XX派出所", "valid_from" : "2004-08-26", "valid_to" : "2034-08-26" } } ] }} 状态码： 400 失败响应样例 { "error_code" : "IVS.0003", "error_msg" : "Some necessary request parameters in req_data is null."}

请求示例 使用身份证正、反面图片进行身份核验 POST https://{endpoint}/v2.0/ivs-idcard-extention{ "meta" : { "uuid" : "user_defined" }, "data" : { "req_data" : [ { "idcard_image1" : "/9j/4BBQSkZJRgABAgEASB...", "idcard_image2" : "/9j/4BBQSkZJRgABAgEASB..." } ] }}

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 meta Meta object 请求元数据，例如表征本次请求的唯一标注uuid。 result result object 调用返回结果。 表7 Meta 参数 参数类型 描述 uuid String 唯一标识此次请求的ID，用户自定义，不超过64位。 表8 result 参数 参数类型 描述 service_name String 子服务名称。 count Integer 执行检测的数量，与resp_data字段对应。 resp_data Array of ExtentionRespDataByIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表9 ExtentionRespDataByIdCardImage 参数 参数类型 描述 verification_result String 审核校验结果： "valid"表示身份审核通过； "invalid"表示身份审核不通过； "nonexistent"表示数据源没有该身份证号码，这种情况一般是被验证人正在办理户籍迁移，或者被验证人是军人或政要。 verification_message String 审核校验信息，具体参考校验信息说明 verification_code Integer 审核校验代码，具体参考校验信息说明 idcard_result IdcardResult object 身份证图像的 文字识别 结果，具体参见IdcardResult。 表10 IdcardResult 参数 参数类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String 民族。 address String 地址。 issue String 发证机关。 valid_from String 有效起始日期。 valid_to String 有效结束日期。 状态码： 400 表11 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在 IAM 中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证页面，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 华为云的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String X-Auth-Token值获取方法请参见认证鉴权。 Enterprise-Project-Id 否 String 企业项目ID。IVS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 说明： 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用IVS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用IVS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用IVS服务，账单的企业项目会被分类到"default"中。 表2 请求Body参数 参数 是否必选 参数类型 描述 meta 是 Meta object 请求元数据，例如表征本次请求的唯一标注uuid。 data 是 data object 请求消息的数据部分。 表3 Meta 参数 是否必选 参数类型 描述 uuid 否 String 唯一标识此次请求的ID，用户自定义，不超过64位。 表4 data 参数 是否必选 参数类型 描述 req_data 否 Array of ExtentionReqDataByIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ExtentionReqDataByIdCardImage 参数 是否必选 参数类型 描述 idcard_image1 是 String 身份证人像面图像数据，使用base64编码，要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间，支持JPG格式。 idcard_image2 否 String 身份证国徽面图像数据，使用base64编码，要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间，支持JPG格式。

请求示例 使用身份证姓名、号码、人脸图片进行人证核验 POST https://{endpoint}/v2.0/ivs-standard{ "meta" : { "uuid" : "user_defined" }, "data" : { "req_data" : [ { "verification_name" : "张三", "verification_id" : "44***********07", "face_image" : "/9j/4BBQSkZJRgABAgEASB..." } ] }}

响应示例 状态码： 200 OK { "meta" : { "uuid" : "user_defined" }, "result" : { "service_name" : "ivs-standard", "count" : 1, "resp_data" : [ { "verification_result" : "valid", "verification_message" : "Successful certification", "verification_code" : 1000, "similarity" : "65" } ] }} 状态码： 400 失败响应样例 { "error_code" : "IVS.0003", "error_msg" : "Some necessary request parameters in req_data is null."}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String X-Auth-Token值获取方法请参见认证鉴权。 Enterprise-Project-Id 否 String 企业项目ID。IVS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 说明： 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用IVS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用IVS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用IVS服务，账单的企业项目会被分类到"default"中。 表2 请求Body参数 参数 是否必选 参数类型 描述 meta 是 Meta object 请求元数据，例如表征本次请求的唯一标注uuid。 data 是 data object 请求消息的数据部分。 表3 Meta 参数 是否必选 参数类型 描述 uuid 否 String 唯一标识此次请求的ID，用户自定义，不超过64位。 表4 data 参数 是否必选 参数类型 描述 req_data 否 Array of StandardReqDataByNameAndId objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 StandardReqDataByNameAndId 参数 是否必选 参数类型 描述 verification_name 是 String 被验证人的姓名。 verification_id 是 String 被验证人的身份证号码。 face_image 是 String 现场人像图像数据，使用base64编码，要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间，支持JPG格式。 detail 否 Boolean 响应参数similarity是否详细显示,默认为false。 true表示响应中的similarity为0~1000的小数。 false表示响应中的similarity为0~100的整数。 crop 否 Boolean 是否允许对入参face_image进行人脸检测及图片裁剪，默认为true，表示允许。

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 meta Meta object 请求元数据，例如表征本次请求的唯一标注uuid。 result result object 调用返回结果。 表7 Meta 参数 参数类型 描述 uuid String 唯一标识此次请求的ID，用户自定义，不超过64位。 表8 result 参数 参数类型 描述 service_name String 子服务名称。 count Integer 执行检测的数量，与resp_data字段对应。 resp_data Array of StandardRespDataByNameAndId objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表9 StandardRespDataByNameAndId 参数 参数类型 描述 verification_result String 审核校验结果： "valid"表示身份审核通过； "invalid"表示身份审核不通过； "nonexistent"表示数据源没有该身份证号码，这种情况一般是被验证人正在办理户籍迁移，或者被验证人是军人或政要。 verification_message String 审核校验信息，具体参考校验信息说明 verification_code Integer 审核校验代码，具体参考校验信息说明 similarity String 人像相识度。取值范围[0,100]，当入参detail为true时，取值范围为[0,1000]。 状态码： 400 表10 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

IdcardResult 身份证 图像文字识别 结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String 民族。 address String 地址。 issue String 发证机关。 valid_from String 有效起始日期。 valid_to String 有效结束日期。 表2 VideoResult 参数 参数类型 描述 alive Boolean 是否是活体。 actions Array of ActionsList objects 动作列表。 picture String 检测出最大人脸的图片base64。 表3 ActionsList 参数 参数类型 描述 confidence Double 置信度，取值范围0～1。 action Integer 动作编号，取值范围：[1,2,3,4]，其中： 1：左摇头 2：右摇头 3：点头 4：嘴部动作 父主题： 公共数据结构

约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内。 支持图像中身份证要求水平放置。 目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。 封装格式：mp4、avi、flv、webm、asf、mov。 视频编码格式：h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。 父主题： 使用前必读

生僻字识别不成功说明 由于历史原因，公安部门在办理身份证登记身份信息时，使用了微软或其他输入法，将生僻字以PUA编码形式记录在了公安数据库中。随着信息化发展，这些生僻字以新的编码被国家标准GB18030收录。如今，在手机及通用计算机上都是使用新的编码输入和显示这些生僻字，但由于实名认证时公安系统是根据汉字编码进行比较，而这些生僻字PUA编码和GB18030编码并不一致，所以核验不会通过。 解决方案： 通过第三方网站提供的生僻字查询功能，传入生僻字以其他方式编码的姓名进行核验（https://name.vurls.cn/ui/index/uigen/）。 以更正信息为由到公安机关申请换证，以新的通用编码重新录入姓名。

终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人证核身的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人证核身的终端节点 区 域名 称 区域 终端节点（Endpoint） 部署服务 华北-北京四 cn-north-4 ivs.cn-north-4.myhuaweicloud.com 标准版（三要素）、证件版（二要素） 父主题： 使用前必读

错误码说明 表1 错误码 状态码 错误码 错误信息 说明 处理措施 400 IVS.0001 Request parameter meta is null or empty. 请求体参数为null或空。 请参考API文档填写请求Body信息，并检查请求body格式是否正确。 400 IVS.0002 Request parameter req_data is redundant. 请求体参数冗余，req_data的元素数量大于1。 req_data列表中当前仅支持1个元素。 400 IVS.0003 Some necessary request parameters in req_data is null. 请求参数有一些必要的参数为null。 请参考API文档填写必要的参数后重试。 400 IVS.0004 Image base64 size is more than 4MB or less than 10KB. 图像的base64数据量大于4MB或小于10KB。 要求base64编码后大小不超过4MB。图像各边的像素大小在300到8000px之间。 400 IVS.0005 Video base 64 size is more than 10MB or less than 10KB. 视频的base 64数据量大于10MB或小于10KB。 要求base 64编码后大小不超过10MB。建议客户端压缩至200KB至2MB。 400 IVS.0006 The input face image is invalid. 输入的人脸图像不合法。 要求base64编码后大小不超过4MB。图像各边的像素大小在300到4000px之间，支持JPG格式。 400 IVS.0007 Id card image error: %s. Please try another image. 输入的身份证图像错误，请换张图像重试。 请检查身份证图片是否正常，图片中文字清晰，并根据具体错误信息更换图片。 400 IVS.0008 live detect error: %s. Please check your input. 活体检测失败，请检查输入。 请检查视频是否正常，视频中的人的头部和脸部符合动作要求，并根据具体错误信息更换视频或修改动作列表。 400 IVS.0009 face detect error: %s. Please check your input. 人脸检测失败，请检查输入。 请检查人脸图片是否正常，图片中有清晰的人脸，并根据具体错误信息更换图片。 400 IVS.0010 face compare error: %s. Please check your input. 人脸比对失败，请检查输入。 请检查输入图片base64中是否包含人脸。 400 IVS.0011 The request param has wrong format, the length of %s exceeds %s bytes. The request param has wrong format, error in parsing %s, %s type expected. The request param has wrong format, %s is null or empty. The request param has wrong format, verification_name contain invalid characters. The request param has wrong format, verification_id length must equal 15 or 18. The request param has wrong format, verification_id is invalid. 请求参数格式错误，参数长度超出范围。 请求参数格式错误，解析参数出现错误。 请求参数格式错误，参数的值为null或空。 请求参数格式错误，verification_name 包含了无效字符。 请求参数格式错误，verification_id长度需为15位或18位。 请求参数格式错误，verification_id无效。 请将参数长度设置在相应范围内。 请参考API文档，修改对应参数的类型。 请检查参数名是否填写正确，以及参数名对应的值是否有填写。 请检查verification_name是否为有效的姓名。 请检查verification_id的长度。 请检查verification_id是否为有效的身份证号码。 400 IVS.0012 Lack Header or Header Content-Type is empty. 缺少请求头或请求头为空。 请参考API文档填写请求头。 400 IVS.0013 The authentication token is abnormal. Token异常。 请参考认证鉴权重新 获取Token 。 400 IVS.0014 The service has been frozen. 服务已冻结。 请检查是否有欠费。 400 IVS.0015 The subservice has not been subscribed. 服务未开通。 请登录控制台开通人证核身服务。 已开通情况下，检查服务的开通区域和调用API时，url中填写的区域是否一致。 500 IVS.0101 Service inner error. 服务内部错误。 请联系华为云支持人员。 当您调用API时，如果遇到“APIGW”,“APIG”开头的错误码，请参见API网关错误码进行处理。

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 meta Meta object 请求元数据，例如表征本次请求的唯一标注uuid。 result result object 调用返回结果。 表7 Meta 参数 参数类型 描述 uuid String 唯一标识此次请求的ID，用户自定义，不超过64位。 表8 result 参数 参数类型 描述 service_name String 子服务名称。 count Integer 执行检测的数量，与resp_data字段对应。 resp_data Array of RespDataByIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表9 RespDataByIdCardImage 参数 参数类型 描述 verification_result String 审核校验结果： "valid"表示身份审核通过； "invalid"表示身份审核不通过； "nonexistent"表示数据源没有该身份证号码，这种情况一般是被验证人正在办理户籍迁移，或者被验证人是军人或政要。 verification_message String 审核校验信息，具体参考校验信息说明 verification_code Integer 审核校验代码，具体参考校验信息说明 similarity String 人像相识度。取值范围[0,100]，当入参detail为true时，取值范围为[0,1000]。 idcard_result IdcardResult object 身份证图像的文字识别结果，具体参见IdcardResult。 表10 IdcardResult 参数 参数类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String 民族。 address String 地址。 issue String 发证机关。 valid_from String 有效起始日期。 valid_to String 有效结束日期。 状态码： 400 表11 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求示例 使用身份证正、反面图片、人脸图片进行人证核验 POST https://{endpoint}/v2.0/ivs-standard{ "meta" : { "uuid" : "user_defined" }, "data" : { "req_data" : [ { "idcard_image1" : "/9j/4AAQSkZJRgABAgEASA...", "idcard_image2" : "/9j/4AAAAABQSkZJRgABAg...", "face_image" : "/9j/4BBQSkZJRgABAgEASB..." } ] }}

响应示例 状态码： 200 OK { "meta" : { "uuid" : "user_defined" }, "result" : { "service_name" : "ivs-standard", "count" : 1, "resp_data" : [ { "verification_result" : "valid", "verification_message" : "Successful certification", "verification_code" : 1000, "similarity" : "65", "idcard_result" : { "name" : "张三", "sex" : "男", "birth" : "2000-03-06", "ethnicity" : "汉", "address" : "XX省XX市XX区XX街道XX号", "number" : "44***********07", "issue" : "XX省XX市XX区XX派出所", "valid_from" : "2004-08-26", "valid_to" : "2034-08-26" } } ] }} 状态码： 400 失败响应样例 { "error_code" : "IVS.0003", "error_msg" : "Some necessary request parameters in req_data is null."}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String X-Auth-Token值获取方法请参见认证鉴权。 Enterprise-Project-Id 否 String 企业项目ID。IVS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 说明： 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用IVS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用IVS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用IVS服务，账单的企业项目会被分类到"default"中。 表2 请求Body参数 参数 是否必选 参数类型 描述 meta 是 Meta object 请求元数据，例如表征本次请求的唯一标注uuid。 data 是 data object 请求消息的数据部分。 表3 Meta 参数 是否必选 参数类型 描述 uuid 否 String 唯一标识此次请求的ID，用户自定义，不超过64位。 表4 data 参数 是否必选 参数类型 描述 req_data 否 Array of ReqDataByIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ReqDataByIdCardImage 参数 是否必选 参数类型 描述 idcard_image1 是 String 身份证人像面图像数据，使用base64编码，要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间，支持JPG格式。 idcard_image2 否 String 身份证国徽面图像数据，使用base64编码，要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间，支持JPG格式。 face_image 是 String 现场人像图像数据，使用base64编码，要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间，支持JPG格式。 detail 否 Boolean 响应参数similarity是否详细显示,默认为false。 true表示响应中的similarity为0~1000的小数。 false表示响应中的similarity为0~100的整数。 crop 否 Boolean 是否允许对入参face_image进行人脸检测及图片裁剪，默认为true，表示允许。

请求示例 使用身份证姓名、号码进行身份核验 POST https://{endpoint}/v2.0/ivs-idcard-extention{ "meta" : { "uuid" : "user_defined" }, "data" : { "req_data" : [ { "verification_name" : "张三", "verification_id" : "44***********07" } ] }}

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 meta Meta object 请求元数据，例如表征本次请求的唯一标注uuid。 result result object 调用返回结果。 表7 Meta 参数 参数类型 描述 uuid String 唯一标识此次请求的ID，用户自定义，不超过64位。 表8 result 参数 参数类型 描述 service_name String 子服务名称。 count Integer 执行检测的数量，与resp_data字段对应。 resp_data Array of ExtentionRespDataByNameAndId objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表9 ExtentionRespDataByNameAndId 参数 参数类型 描述 verification_result String 审核校验结果： "valid"表示身份审核通过； "invalid"表示身份审核不通过； "nonexistent"表示数据源没有该身份证号码，这种情况一般是被验证人正在办理户籍迁移，或者被验证人是军人或政要。 verification_message String 审核校验信息，具体参考校验信息说明 verification_code Integer 审核校验代码，具体参考校验信息说明 状态码： 400 表10 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

响应示例 状态码： 200 OK { "meta" : { "uuid" : "user_defined" }, "result" : { "service_name" : "ivs-idcard-extention", "count" : 1, "resp_data" : [ { "verification_result" : "valid", "verification_message" : "Successful certification", "verification_code" : 1000 } ] }} 状态码： 400 失败响应样例 { "error_code" : "IVS.0003", "error_msg" : "Some necessary request parameters in req_data is null."}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String X-Auth-Token值获取方法请参见认证鉴权。 Enterprise-Project-Id 否 String 企业项目ID。IVS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 说明： 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用IVS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用IVS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用IVS服务，账单的企业项目会被分类到"default"中。 表2 请求Body参数 参数 是否必选 参数类型 描述 meta 是 Meta object 请求元数据，例如表征本次请求的唯一标注uuid。 data 是 data object 请求消息的数据部分。 表3 Meta 参数 是否必选 参数类型 描述 uuid 否 String 唯一标识此次请求的ID，用户自定义，不超过64位。 表4 data 参数 是否必选 参数类型 描述 req_data 否 Array of ExtentionReqDataByNameAndId objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ExtentionReqDataByNameAndId 参数 是否必选 参数类型 描述 verification_name 是 String 被验证人的姓名。 verification_id 是 String 被验证人的身份证号码。

快速接入 可联合“设备接入”服务，任意一点可管理全球设备，通过统一的设备发放，选择就近的 设备接入服务 ，降低接入时延；同时企业可以通过全球任意一个设备接入服务，通过切换区域的方式，登录不同区域的 物联网平台 ，实现跨区域管理全球不同公有云节点下设备。设备接入服务同时支持多协议、多网络、集成Agent接入： 支持HTTPS+MQ TTS 、MQTTS、LWM2M/CoAP协议接入。 支持有线和无线的接入方式，如固定宽带、2G/3G/4G、Z-Wave、ZigBee、eLTE等。 支持Agent接入：支持通过集成华为Agent Tiny SDK接入。

GSL权限 默认情况下，管理员创建的IAM用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 由于缓存的影响，对用户、用户组授予 全球SIM联接 系统策略后，需要等待10-15分钟策略才能生效。 若通过控制台使用全球SIM联接服务，请在授予系统策略后退出登录，之后重新登录继续使用。 若使用全球SIM联接的应用侧API，请在授予系统策略后，重新获取IAM用户token。

调用API获取项目ID 获取项目ID的接口为“GET https://{endpoint}/v3/projects”，其中“{endpoint}”为IAM的终端节点。接口的认证鉴权请参见认证鉴权。 响应示例如下，例如，人证核身服务部署的区域为“cn-north-4”，响应消息体中查找“name”为“cn-north-4”，其中“projects”下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22https://support-intl.huaweicloud.com/zh-cn/devg-apisign/api-sign-provide.htmlcd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

计费项&计费模式 表2 全球SIM联接计费模式介绍 计费模式 计费项 计费说明 包年（传统实体卡） 按年套餐包 计费规则：客户订购时一次性支付1年的流量服务费用。中国电信/中国移动计费周期为自然月，中国联通计费周期按上月27号至当月26号。 续订规则：每张卡单独计算失效日期，失效日期为从卡激活当月起算的12个计费周期的期末。需在失效日前一个月进行续订操作。 未启用前向流量池：每张实体卡单独计算流量，超流量自动断网，次月恢复配额。 启用前向流量池：池内的激活状态实体卡共享流量，当实际使用流量大小超过池内卡的总流量，池内的所有卡都会自动断网，次月恢复配额。 按需 后向流量池月功能费 后向流量池流量费 客户在创建后向流量池订单后，会根据每月后向流量池卡的激活状态以及后向流量池总用量收取实际的费用。 后向流量池月功能费按照当月后向流量池内，卡状态为在用或停用的卡总数进行收取。若某张未激活卡在当月激活，或某张已激活卡在当月拆机，该张卡当月的月功能费仍然会被收取。 后向流量池流量费按照当月后向流量池的实际流量累计量进行收取。

步骤三：登录宝塔面板。 在浏览器地址栏中输入上述步骤2记录的宝塔面板地址。 地址格式为：http://弹性公网IP:随机端口号/随机字符串。本例为：http://1.95.xx.xx:28796/0ed54a3b。 显示如下界面： 图2 登录宝塔面板 输入上述步骤2记录的账户和密码登录宝塔面板，根据提示阅读并勾选《用户协议》。 登录后如果出现如下提示，请单击“未有账号，免费注册”在宝塔官网注册。 在宝塔官网注册后，在此输入注册的手机号和密码绑定宝塔官网账号。 根据业务需要安装基础组合软件。 请选择LNMP（推荐）或者LAMP基础组合软件，单击“一键安装”，等待安装直至结束。 后续也可以在“软件商店”中自行选择并安装其他软件。 至此，您已成功安装并登录宝塔面板。您现在可以开始通过宝塔面板部署网站，更多关于宝塔面板的信息请参见宝塔面板官网。

规格 选择订购不同规格的物联网卡流量套餐，会生成不同的价格。详细的服务资费费率标准请参见产品价格详情。 表1 规格说明 规格 说明 物联网实体卡类型 传统实体卡，从卡形态上区分为贴片卡、插拔卡。点此了解更多 贴片卡：（5mm*6mm）贴片卡、（2mm*2mm）贴片卡。 插拔卡：标准卡（25mm*15mm）、Micro卡（15mm*12mm）、Nano卡（12mm*9mm）。 说明： 运营商套餐需在开卡时确定，开卡后不可更改，默认按年购买。 物联网流量套餐 物联网流量套餐规格确定每月使用流量额度，每月流量规格大小会直接影响购买金额。 蜂窝网络类型（实体卡） 中国移动：仅支持单4G网络。 中国电信：仅支持单4G网络。 中国联通：同时支持3G/4G网络。 三网：仅支持单4G网络。