文档识别API开发文档

小太阳

3、服务主要功能描述

翔云文档识别服务，可快速精准识别扫描文档、长微博、自然场景下的各种文字。

1) 通过https协议 post方法上传各种文档图像文件，通过https接口进行识别；

2) 将识别结果以XML或json格式返回给用户；

4、服务调用约束

在调用文档识别接口前，请您确保客户端程序或设备网络连接通畅，要求图像文件大小在200KB左右，扫描图像建议分辨率为300DPI，图像小于3M。

三、接口说明

接口地址，图片为base64流：

图片为file格式：

（注：调用图片为base64流接口时传参数img，调用图片为file格式接口传参数file）

接口调用方法：post

3、请求参数

名称	类型	必填	说明
img	String	是	上传的文件(图片的base64流)
file	MultipartFile	是	上传的文件(上传文件的字段名必须是“file”)
key	String	是	用户ocrKey
secret	String	是	用户ocrSecrert
typeId	Integer	是	识别类型（文档【简体中文】1991；文档【繁体中文】2991；文档【英文】3991；其他详见附录）
format	String	是	返回格式(xml或者json)，如果format为空，则默认返回xml
img	String	是	上传的文件(图片的base64流)

识别结果字符串
<status/>标签显示了识别状态，大于等于“0”代表识别成功【“0”代表查询成功，“1”代表未查到数据，“2”代表查询失败】，小于“0”代表识别失败，失败的原因在<value/>中描述。

调用错误码

status值	描述
-1	用户已屏蔽
-2	用户key或secret验证错误
-3	服务次数不足
-4	用户未找到
-6	系统异常
-7	图片不可为空，参数不可为空
-8	类型错误