阿里云-文档结构化还原识别

文档结构化还原识别

接口地址：http://route.showapi.com/2031-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起 

参数名称	类型	默认值	示例值	必须	描述
img	String			否	图片二进制数据的base64编码或者图片url 注意传base64时:data:image/png;base64,要去掉
url	String		https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/wjy/%E6%96%87%E6%A1%A3.jpg	否	图像url地址：图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px，支持jpg/png/bmp格式，和img参数只能同时存在一个
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/2031-1","my_appId","my_appSecret") .addTextPara("img","") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/wjy/%E6%96%87%E6%A1%A3.jpg") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
sid	String	bfcb418f71fd057f11ea4e17b15688dc27f9d4c6a47a867a376f251706266353341da54c	/唯一id，用于问题定位
prism_version	String	1.0.6	算法版本
prism_wnum	Number	2	识别的文字块的数量，prism_wordsInfo数组大小
angle	Number		角度， 范围：0-360,0表示向上，90表示向右，180表示向下，270度表示向左
prism_wordsInfo	Object[]		识别的文字的具体内容
-  0	Object
-  word	String	2017	文字块
-  prob	Number	99	置信度
-  pos	Object[]		文字块的位置，按照文字块四个角的坐标顺时针排列，分别为左上XY坐标、右上XY坐标、右下XY坐标、左下XY坐标 "pos": [
-  0	Object
-  x	Number	107
-  y	Number	203
-  1	Object
-  x	Number	247
-  y	Number	203
-  2	Object
-  x	Number	247
-  y	Number	213
-  3	Object
-  x	Number	107
-  y	Number	213
-  charInfo	Object[]		单字信息
-  0	Object
-  word	String	2	单字文字
-  prob	Number	99	单字置信度
-  x	Number	777	/单字左上角横坐标
-  y	Number	2993	单字左上角纵坐标
-  w	Number	26	单字宽度
-  h	Number	30	单字长度
-  tableId	Number	0	如果该文字块在表格内则存在该字段，tableId表示表格的id
-  tableCellId	Number	0	如果该文字块在表格内则存在该字段，表示表格中单元格的id
-  rowId	Number	0	行id
-  paragraphId	Number	0	段id
-  pageId	Number	0	页id
prism_tablesInfo	Object[]		表格信息，如果不存在表格，则改字段内容为空
-  0	Object
-  tableId	Number	0	表格id，和prism_wordsInfo信息中的tableId对应
-  xCellSize	Number	1	表格中横坐标单元格的数量
-  yCellSize	Number	1	表格中纵坐标单元格的数量
-  cellInfos	Object[]		单元格信息，包含单元格在整个表格中的空间拓扑关系
-  0	Object
-  tableCellId	Number	0	表格中单元格id，和prism_wordsInfo信息中的tableCellId对应
-  word	String	：2017	/单元格中的文字
-  xsc	Number	0	xStartCell缩写，表示横轴方向该单元格起始在第几个单元格，第一个单元格值为0
-  xec	Number	0	xEndCell缩写，表示横轴方向该单元格结束在第几个单元格，第一个单元格值为0，如果xsc和xec都为0说明该文字在横轴方向占据了一个单元格并且在第一个单元格内
-  ysc	Number	0	yStartCell缩写，表示纵轴方向该单元格起始在第几个单元格，第一个单元格值为0
-  yec	Number	0	yEndCell缩写，表示纵轴方向该单元格结束在第几个单元格，第一个单元格值为0
-  pos	Object[]		单元格位置，按照单元格四个角的坐标顺时针排列，分别为左上XY坐标、右上XY坐标、右下XY坐标、左下XY坐标
-  0	Object
-  x	Number	107
-  y	Number	203
-  1	Object
-  x	Number	247
-  y	Number	203
-  2	Object
-  x	Number	247
-  y	Number	213
-  3	Object
-  x	Number	107
-  y	Number	213
prism_pagesInfo	Object[]		分页信息
-  0	Object
-  pageId	Number	0	页id，和prism_wordsInfo信息中的pageId对应
-  word	String	2017	文字内容
prism_paragraphsInfo	Object[]		分段信息
-  0	Object
-  paragraphId	Number	0	段id，和prism_wordsInfo信息中的paragraphId对应
-  word	String	2017	文字内容
prism_rowsInfo	Object[]		成行信息
-  0	Object
-  rowId	Number	0	行id，和prism_wordsInfo信息中的rowId对应
-  word	String	2017	文字内容
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "2e0be72becda41f3b30edc1180ed28e7", "showapi_res_code": 0, "showapi_res_body": { "sid": "bfcb418f71fd057f11ea4e17b15688dc27f9d4c6a47a867a376f251706266353341da54c", "prism_version": "1.0.6", "prism_wnum": 2, "angle":"", "prism_wordsInfo": [ { "word": "2017", "prob": 99, "pos": [ { "x": 107, "y": 203 }, { "x": 247, "y": 203 }, { "x": 247, "y": 213 }, { "x": 107, "y": 213 } ], "charInfo": [ { "word": "2", "prob": 99, "x": 777, "y": 2993, "w": 26, "h": 30 }, { "word": "0", "prob": 99, "x": 803, "y": 2989, "w": 32, "h": 37 }, { "word": "1", "prob": 99, "x": 835, "y": 2989, "w": 38, "h": 39 }, { "word": "7", "prob": 99, "x": 873, "y": 2988, "w": 38, "h": 40 } ], "tableId": 0, "tableCellId": 0, "rowId": 0, "paragraphId": 0, "pageId": 0 } ], "prism_tablesInfo": [ { "tableId": 0, "xCellSize": 1, "yCellSize": 1, "cellInfos": [ { "tableCellId": 0, "word": "：2017", "xsc": 0, "xec": 0, "ysc": 0, "yec": 0, "pos": [ { "x": 107, "y": 203 }, { "x": 247, "y": 203 }, { "x": 247, "y": 213 }, { "x": 107, "y": 213 } ] } ] } ], "prism_pagesInfo": [ { "pageId": 0, "word": "2017" } ], "prism_paragraphsInfo": [ { "paragraphId": 0, "word": "2017" } ], "prism_rowsInfo": [ { "rowId": 0, "word": "2017" } ] } }