调用API实现身份证识别

准备工作

注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。

步骤1：开通服务

1. 登录华为云文字识别服务管理控制台。

   控制台左上角默认显示服务部署在“华北-北京四”区域，请您根据业务需要选择对应区域，各服务部署的区域具体请参见终端节点。

2. 选择需要使用的API，进行开通。

   本示例中需开通身份证识别API。

   

   • 由于OCR服务在发布上线时依托于ModelArts平台，因此会出现以“ModelArts”开头的错误码。详细的错误码请参见错误码。
   • 如调用服务失败提示ModelArts.4204报错，可能是服务未开通或开通服务区域与调用服务的区域不一致原因造成的，请在调用服务前进入控制台开通并检查开通与待调用区域是否一致。

步骤2：配置环境

1. 下载并安装Postman。

   Postman建议使用7.24.0版本。

2. 下载文字识别服务Postman配置文件。

   下载地址：SDK.postman_collection_v2.json。

3. 导入配置文件。
   1. 打开并登录Postman。
   2. 单击左上角“File > Import > Import File > Choose Files”导入配置文件。
      图1 导入配置文件
      

      配置文件导入成功后，将显示在Postman左侧导航栏中。

      图2 配置文件
      
      

      本配置文件中服务所属区域为“华北-北京四”，如果您在开通服务时，选择了其他区域，在执行步骤3、步骤4时请将配置文件中的所有“cn-north-4”字段替换为实际区域，服务部署的区域具体请参见终端节点。

步骤3：Token认证鉴权

Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。

1. 在Postman左侧导航栏中单击“get-token”配置文件。
2. 单击“Body”配置项。
   图3 Token认证鉴权
   
3. 填写华为云用户名、密码、账号名、项目部署区域。
   • uesrname：IAM用户名。
   • domainname：账号名。
   • password：密码。
   • project name:项目部署区域（示例默认以”cn-north-4”(“华北-北京四”)区域为例）。

     如您在开通服务时，选择了其他区域，请将图③处和④处的”cn-north-4”共同修改为实际区域，服务部署的区域具体请参见终端节点。

   请登录“我的凭证”页面，获取IAM用户名、账号名，填写至username、domainname参数处。

   

   

   获取Token时，如果出现The userInfo is wrong、APIGW.0101、The username or password is wrong报错以及"Error:Header overflow"的标头溢出问题，请参见Token认证鉴权类报错解决。

4. 单击“Send”，发送请求，获取并复制Token。

   获取返回结果“Headers”中的“X-Subject-Token”即为Token。Token有效期为24小时。

   图4 获取Token
   

步骤4：调用服务

1. 在Postman左侧导航栏中单击“OCR_idcard”配置文件。
   

   根据自身文字识别服务需求选择相应的POST类型。（OCR_idcard:身份证识别，OCR_auto_classification:智能分类识别，OCR-webimage:网络图片识别)

2. 登录我的凭证，获取“华北-北京四”区域的项目ID，替换配置文件URL中的{project_id}。

   如您选择的其他区域(非“华北-北京四”)，请将图②处的”cn-north-4”修改为实际区域并替换相应的{project_id}，服务部署的区域具体请参见终端节点。

3. 单击“Headers”配置项。将获取的Token复制到“X-Auth-Token”值中。
   图5 修改配置文件
   
4. 单击“Body”配置项，将待识别图片的base64编码填写到“image”参数中。

   示例中“side”参数值为“front”，代表识别身份证正面。详细的API参数介绍请参见API说明。

   图6 修改配置文件
   
5. 单击“Send”，发送请求，获取调用结果。

   {
       "result": {
           "name": "xx", 
           "sex": "女", 
           "ethnicity": "满", 
           "birth": "1990-xx-xx", 
           "address": "河北省承德市围场满族蒙古族自治县金车路", 
           "number": "3892011990012xxxxx"
       }
   }