提交OCR异步识别任务后,调用本接口查询识别结果。

描述

业务接口/green/image/results

客户端定时轮询查询OCR异步识别结果。建议您将查询间隔设置为30秒,最长不能超出1个小时,否则结果将会丢失。关于调用异步OCR图文识别,请参考提交OCR异步识别任务

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个JSON数组,字段说明如下:
名称 类型 是否必需 描述
body JSON数组 要查询的taskId列表。最大长度不超过1,000。

返回参数

返回结果说明,参见返回结果

返回body中的Data字段是JSON数组,每一个元素包含如下字段:
名称 类型 是否必需 描述
code 整型 错误码,和HTTP的status code一致。
msg 字符串 错误描述信息。
dataId 字符串 对应的请求中的dataId
taskId 字符串 该检测任务的ID。
url 字符串 对应的请求中的URL。
extras JSON对象 附加信息。该值可能会调整,建议您不要在业务上进行依赖。
results 数组 返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体,具体结构描述见result
表 1. result
名称 类型 是否必需 描述
scene 字符串 检测场景,取值为:ocr
label 字符串 检测结果的分类。取值为:
  • normal:正常图片,未检测到文字
  • ocr:含文字的图片
suggestion 字符串 建议用户执行的操作,取值范围:
  • pass:未识别出目标对象(如文字)
  • review:识别出目标对象(如文字)
rate 浮点数 结果为目标分类的概率,取值范围为[0.00-100.00]。值越高,表示越有可能属于目标分类。
ocrLocations 数组 被检测图片有文字时,返回识别出来的单条文字信息,具体结构描述见ocrLocation
ocrData 数组 被检测图片有文字时,返回识别出来的所有文字信息组合。通常文本组合信息存储于数组第一个元素上。
表 2. ocrLocation
名称 类型 是否必需 描述
text 字符串 识别出来的单条文本信息。
x 浮点数 以图片左上角为坐标原点,文字区域左上角到y轴距离。
y 浮点数 以图片左上角为坐标原点,文字区域左上角到x轴距离。
w 浮点数 文字区域的宽度。
h 浮点数 文字区域的高度。

示例

请求示例
["aaa25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695"]
返回示例
{
   "code":   200 ,
   "data":  [
    {
       "code":   200 ,
       "dataId":   "675876e4-6698-4f92-8bd9-19f5e20035fb" ,
       "extras":  {},
       "msg":   "OK" ,
       "results":  [
        {
           "label":   "ocr" ,
           "ocrData":  [
             "本文提供了调用图片异步检测任务的具体内容,"
          ],
           "ocrLocations":  [
            {
               "h":   19 ,
               "text":   "本文提供了调用图片异步检测任务的具体内容," ,
               "w":   362 ,
               "x":   31 ,
               "y":   11 
            }
          ],
           "rate":   99.91 ,
           "scene":   "ocr" ,
           "suggestion":   "review" 
        }
      ],
       "taskId":   "img7Iljku7br7u66Z29EsepH9-1pfBUQ" ,
       "url":   "http://green-system.oss-cn-hangzhou.aliyuncs.com/green_demo_image/2018-08-02/1533193802331_123.jpg?Expires=1533280202&OSSAccessKeyId=xVyGMnDdJmSfyPgW&Signature=MEMawE9jrElam%2BOFyjIi0YazMfA%3D" 
    }
  ],
   "msg":   "OK" ,
   "requestId":   "992C7849-AA45-4055-8F82-8D44D64C15E3" 
}