背景信息
对于首次使用通用型OCR业务的用户,如希望快速的解决业务需求问题,可参照本实践案例,通过应用场景、产品功能、前提条件、前期准备、实践步骤等说明,实现业务快速接入。
应用场景
文档数字化: OCR可以将纸质文件转换为数字格式,方便文件存储和信息传输,提高办公效率。
办公扫描: OCR可以将纸质文件扫描为电子文档,方便存储和检索,减少纸张使用。
产品功能
快速、准确的OCR文字检测和识别服务,针对多场景、多颜色的OCR文字检测和识别需求,最终输出检测到的文字内容和文本行坐标信息,解决不易识别、手动输入等场景操作效低下的问题。
实践流程
前提条件
- 购买通用型OCR相关产品,订购流程详情请查看产品购买;
- 创建通用型OCR应用及开通通用型OCR应用,开通服务流程详情请查看创建应用及开通应用;
- 查看购买通用型OCR产品情况,产品整体情况请查看用户控制台。
前期准备
构造请求
- 请求地址:{终端节点地址}+{对应接口URL},详情查看构造请求;
- 终端节点地址:https://ai-global.ctapi.ctyun.cn;
- 对应接口URL:/v1/aiop/api/2f3p1pnxpqm8/ocrdetect/ocr/v1/image.json。
认证鉴权
认证鉴权详细版本,点击查看认证鉴权。
1.信息的获取
- 登录云网门户,在“控制台”->“个人中心”->“安全设置”->“用户AccessKey”点击“查看”获取。
2.基本签名流程
- 待签字符串:使用规范请求和其他信息创建待签字符串;
- 计算密钥:使用header、ctyun-eop-sk、ctyun-eop-ak来创建hmac算法的密钥;
- 计算签名:使用第三步的密钥和待签字符串在通过hmacsha256来计算签名;
- 签名应用:将生成的签名信息作为请求消息头添加到HTTP请求中。
3.创建待签名字符串
- 待签名字符串=需要进行签名的header排序后的组合列表+ "\n" + 排序的query + "\n" + toHex(sha256(原封的body));
- 假设你需要将ctyun-eop-request-id、eop-date、host都要签名,则待签名的header构造出来是:ctyun-eop-request-id:123456789\neop-date:20210531T100101Z\nhost:1.1.1.1:9080\n;
- 如果你加入一个ccad的header,同时这个header也需要进行签名,则待签名的header组合:ccad:123\nctyun-eop-request-id:123456789\neop-date:20210531T100101Z\nhost:1.1.1.1:9080\n。
4.构造动态密钥
- 发起请求时,需要构造一个eop-date的时间,这个时间的格式是yyyymmddTHHMMSSZ,言简意赅一些,就是年月日T时分秒Z;
- 先是用申请的ctyun-eop-sk作为密钥,eop-date作为数据,算出ktime;
- 用ktime作为密钥,申请的ctyun-eop-ak作为数据,算出kAk;
- 用kAk作为密钥,eop-date的年月日值作为数据,算出kdate。
5.签名应用
- 由“构造动态密钥”和“创建待签名字符串”分别得出来的待签名字符串string_sigture、kdate生成出Signature;
- 得到Eop-Authorization,然后将数据整合成header放在http_client内,发出即可。
实践步骤
详情查看API通用型OCR。