如何使用API调用华为云OCR服务
本章节通过使用Postman软件,调用OCR服务身份证识别API,帮助快速熟悉OCR服务API的使用方法。
使用OCR服务API的详细步骤如下所示:
准备工作
已注册华为云帐号,并完成实名认证,帐号不能处于欠费或冻结状态。
步骤1:开通服务
- 登录华为云文字识别服务管理控制台。
控制台左上角默认显示服务部署在“华北-北京四”区域,请您根据业务需要选择对应区域,各服务部署的区域具体请参见终端节点。
- 选择需要使用的API,进行开通。
如未开通服务,调用服务时会提示ModelArts.4204报错,请在调用服务前先进入控制台开通服务,并注意开通服务区域与调用服务的区域保持一致。
步骤2:配置环境
- 下载并安装Postman。
- 下载文字识别服务Postman配置文件。
- 导入配置文件。
- 打开并登录Postman。
- 单击左上角“File > Import > Import File > Choose Files”导入配置文件。图1 导入配置文件
配置文件导入成功后,将显示在Postman左侧导航栏中。
图2 配置文件本配置文件中服务所属区域为“华北-北京四”,如果您在开通服务时,选择了其他区域,在执行步骤3、步骤4时请将配置文件中的所有“cn-north-4”字段替换为实际区域,服务部署的区域具体请参见终端节点。
步骤3:Token认证鉴权
Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需要使用Token进行鉴权。
- 在Postman左侧导航栏中单击“get-token”配置文件。
- 单击“Body”配置项。填写用户名、密码、账号名。
- uesrname:IAM用户名。
- domainname:帐号名。
- password:密码。
请登录“我的凭证”页面,获取IAM用户名、账号名,填写至username、domainname参数处。
图3 Token认证鉴权 - 单击“Send”,发送请求,获取并复制Token。
获取返回结果“Headers”中的“X-Subject-Token”即为Token。Token有效期为24小时。
图4 获取Token
步骤4:调用服务
- 在Postman左侧导航栏中单击“OCR_idcard”配置文件。
- 登录我的凭证,获取“华北-北京四”区域的项目ID,替换配置文件URL中的{project_id}。
- 单击“Headers”配置项。将获取的Token复制到“X-Auth-Token”值中。图5 修改配置文件
- 单击“Body”配置项,将待识别图片的base64编码填写到“image”参数中。
示例中“side”参数值为“front”,代表识别身份证正面。详细的API参数介绍请参见API说明。
图6 修改配置文件 - 单击“Send”,发送请求,获取调用结果。
{ "result": { "name": "xx", "sex": "女", "ethnicity": "满", "birth": "1990-xx-xx", "address": "河北省承德市围场满族蒙古族自治县金车路", "number": "3892011990012xxxxx" } }
