【OCR调试】使用Postman调用华为云OCR服务

使用Postman调用华为云OCR API

1.     开通服务

调用华为云OCR服务前需要确保调用的服务已开通。

详情参考：https://support.huaweicloud.com/api-ocr/ocr_03_0043.html

2.     下载安装Postman

打开下载地址：https://www.getpostman.com/downloads/，选择合适的版本进行下载安装。最新版本的Postman需要注册账号并登陆后才可以使用。

3.     下载华为云OCR postman的SDK配置文件

SDK配置文件名称：SDK.postman_collection.json

下载地址见附件。

4.     加载华为云OCR postman的SDK配置文件

打开postman后点击左上角： file -> Import -> Import File -> Choose File。选取上一步骤中下载的SDK.postman_collection.json。

加载后在左边栏可以看到如下几个配置文件：

5.     获取token

（1）  打开get-token的文件。

（2）  选中Body的配置项。

（3）  添加对应的华为云账户密码（若无特殊配置，华为云主账号和子账号为同一个）。

（4）  修改华为云服务所在的区域，例如需要调用的服务在“华北-北京四”，则修改URL以及body体中的project-name为”cn-north-4”（获取token的华为云服务所在区域需要和调用的服务所在区域一致，否则会导致调用失败），各服务所在区域请查看API说明

（5）  点击右上角Send按钮发送请求，获取返回结果中的token值（Token有效期为24小时）。

6.     获取图片的base64编码

    华为云OCR服务的输入图片参数是图片的base64编码，目前有网站可以提供在线图片base64编码转换，具体操作请自行搜索。这里提供一种利用谷歌浏览器直接进行图片格式转换的方式，操作过程如下：

（1）       打开谷歌浏览器，将本地图片文件直接拖入到浏览器中，浏览器上将会显示图片；

（2）       按下F12，会打开如图5所示的窗口，接下来我们只需要操作右上角的小窗口；

（3）       如下图所示，依次点击1号红框Sources、2号红框图片名，然后在右侧3号红框处就会显示图片的base64编码，按ctrl+A，再按ctrl+c进行全部复制，注意不可以用鼠标右键进行复制。

7.     调用OCR服务

（1）       以调用身份证OCR服务为例，打开步骤3中的OCR-idcard文件。

（2）       如下图修改服务URL，例如我们调用的是华北-北京四的身份证识别服务，服务的URL为：https://ocr.cn-north-4.myhuaweicloud.com/v1.0/ocr/id-card。

各个服务的URL请参考API说明。

（3）       点击Headers选项，复制上一步token值到X-Auth-Token配置中。

（4）       如下图，点击Body选项，复制步骤6获取图片的base64编码值到参数image中

（5）       修改或添加服务的其他的参数，例如身份证服务可以指定识别正面‘front’还是反面”back”。每个服务的参数各不相同，详情参考各服务API说明：

（6）       点击右上角Send按钮发送请求，查看识别结果：

8.     调用其他OCR服务

若想要调用其他OCR服务，只需修改对应的URL，Token，body体即可，例如我们要调用网络图片识别服务，位于华南-广州区域（“cn-south-1”）

（1）       将get-token文件中的URL和project-name从cn-north-4修改为cn-south-1，重新获取华南-广州的token值。

（2）       从服务API说明文档中查找网络截图服务的URL为：https://ocr.cn-south-1.myhuaweicloud.com/v1.0/ocr/web-image。将替换原本调用的身份证URL替换为网络截图服务的URL。

（3）       修改原本获取到的Token为重新获取的华南-广州区域的Token值。

（4）       根据API说明文档添加Body选项中的输入参数。

（5）       发送请求获取结果。

（6）       我们实际上也提供了网络图片识别服务和智能分类识别服务的配置文件供大家对比参考。