文档首页/ 人证核身服务 IVS/ 快速入门/ 调用SDK实现人证核身证件版(二要素)
更新时间:2024-12-17 GMT+08:00
分享

调用SDK实现人证核身证件版(二要素)

人证核身服务软件开发工具包(IVS SDK)是对人证核身服务提供的REST API进行的封装,以简化用户的开发工作。

人证核身证件版(二要素)API为例,介绍如何使用IVS Python SDK。

使用IVS SDK的详细步骤如下所示:

步骤1:开通服务

步骤2:安装SDK

步骤3:获取示例代码

步骤4:调用服务

准备工作前提条件

账号完成实名认证,且不能处于欠费或冻结状态。

步骤1:开通服务

  1. 登录人证核身服务控制台
  2. 选择需要使用的服务,在操作列单击“开通服务”。本示例中开通人证核身证件版(二要素)API。
    图1 开通服务
  3. 服务开通成功后,开通状态显示“已开通”

首次使用服务时,需要先申请开通该服务。服务只需要开通一次即可,后面使用时无需再次申请。如未开通服务,调用服务时会提示IVS.0015报错。

步骤2:安装SDK

  1. 获取并安装IVS Python SDK。

    以PyCharm为例,介绍如何安装SDK。

    在PyCharm中新建一个项目,并单击左下方“Terminal”按钮。分别执行以下命令安装SDK(该SDK支持Python3及以上版本)。

    # 安装核心库
    pip install huaweicloudsdkcore
    # 安装IVS服务库
    pip install huaweicloudsdkivs

  2. 检查SDK是否已正确安装。

    在PyCharm中选择Settings > Project > Python Interpreter,检查SDK是否已正确安装。

步骤3:获取示例代码

获取人脸检测SDK示例代码。

  1. 登录API Explorer,在“代码示例”中选择“Python”

  2. 填写请求Body参数。输入数据填写uuid、verification_name、verification_id
    • uuid:唯一标识此次请求的ID,用户自定义,不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e
    • verification_name:被验证人的姓名
    • verification_id:被验证人的身份证号码

  3. 复制代码示例至PyCharm中。

步骤4:调用服务

  1. 获取AK/SK,替换代码示例中的“<YOUR AK>”“<YOUR SK>”参数。

    登录访问秘钥页面,新增访问秘钥,或使用已有的访问秘钥。访问秘钥为credentials.csv文件,包含AK/SK信息。

  2. 运行代码示例,获取识别结果。

    识别结果返回“valid”,表示认证成功。

相关文档