|
| 接口信息 |
文字识别高精版 |
请求方式：POST 地址：https://ocrimg.market.alicloudapi.com/ocr |
复 制 |
| 请求参数： (Body) |
| 字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
| 图片路径 |
url |
否 |
String(255) |
https://www.zpzzq.com/images/ocrtest.jpg |
http开头格式为JPG/PNG/GIF的图片URL，大小1MB以内。（img或url必传一个） |
| 图像base64 |
img |
否 |
String(MAX) |
/9j/4AAQSkZJR***BAAD/4gI*** |
图像base64字符串，1MB以内（img或url必传一个） |
| 显示版本 |
ver |
否 |
Int |
0 |
版本参数：0、位置解析版；1、行块解析版；2、汇总解析版。 |
|
API地址为https://ocrimg.market.alicloudapi.com/ocr，发起POST请求时，请确保在header中设置Authorization字段，格式为Authorization: APPCODE <您的AppCode>，其中<您的AppCode>替换为实际AppCode。注意：APPCODE与AppCode间有空格。
|
| 成功响应示例： |
|
成功报文解析： |
ver=0时返回示例：
{
"ok": 1,
"msg": "查询成功",
"data": [{
"top": 90,
"left": 299,
"width": 206,
"height": 35,
"words": "冰心散文精选"
}, {
"top": 216,
"left": 158,
"width": 570,
"height": 24,
"words": "........."
}]
}
ver=1时返回示例：
{
"ok": 1,
"msg": "查询成功",
"data": [{
"words": "冰心散文精选"
},
{
"words": "**************"
},
{
"words": "在草地上，和着最柔媚的琴声跳舞。到了酣畅处，自己觉得是个羽"
}
]
}
ver=2时返回示例：
{
"ok": 1,
"msg": "查询成功",
"data": "冰心散文精选自从太平洋舟中，银花世界之夜以后，再不曾见有团圆*******到了酣畅处，自己觉得是个羽"
}
|
|
| 字段名 |
类型 |
示例值 |
描述 |
| ok |
number |
1
|
成功标识：1成功，0失败
|
| msg |
string |
查询成功
|
报文成败描述
|
| data |
object |
[{...}]
|
根据版本显示不同的识别结果
|
| top |
number |
90
|
相对位置--顶部
|
| left |
number |
299
|
相对位置--左边
|
| width |
number |
206
|
行块宽度--像素单位
|
| height |
number |
35
|
行块高度--像素单位
|
| words |
string |
冰心散文精选
|
行块文字内容 |
|
| 失败响应示例： |
|
失败报文解析： |
{
"ok": 0,
"msg": "img或url只能传入一个"
}
|
|
| 字段名 |
类型 |
示例值 |
描述 |
| ok |
number |
0 |
成功标识：1成功，0失败 |
| msg |
string |
img或url只能传入一个
|
报文成败描述 |
|
|
|
| PHP代码 |
注意AppCode安全，验证API参数，处理HTTPS请求时禁用证书验证风险。 |
复 制 |
|
<?php
$host = "https://ocrimg.market.alicloudapi.com";
$path = "/ocr";
$method = "POST";
$appcode = "你自己的AppCode";
$headers = array();
array_push($headers, "Authorization:APPCODE " . $appcode);
//根据API的要求，定义相对应的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = "img=%2F9j%2F4AAQSkZJR***BAAD%2F4gI***&url=https%3A%2F%2Fwww.zpzzq.com%2Fimages%2Focrtest.jpg&ver=0";
$url = $host . $path;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
var_dump(curl_exec($curl));
?>
|
|
| Java代码 |
注意API URL、AppCode正确性，并确保处理HTTPS请求时SSL验证配置。 |
复 制 |
|
public static void main(String[] args) {
String host = "https://ocrimg.market.alicloudapi.com";
String path = "/ocr";
String method = "POST";
String appcode = "你自己的AppCode";
Map headers = new HashMap();
//最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105
headers.put("Authorization", "APPCODE " + appcode);
//根据API的要求，定义相对应的Content-Type
headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map querys = new HashMap();
Map bodys = new HashMap();
bodys.put("img", "/9j/4AAQSkZJR***BAAD/4gI***");
bodys.put("url", "https://www.zpzzq.com/images/ocrtest.jpg");
bodys.put("ver", "0");
try {
/**
* 重要提示如下:
* HttpUtils请从
* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
* 下载
*
* 相应的依赖请参照
* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
*/
HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);
System.out.println(response.toString());
//获取response的body
//System.out.println(EntityUtils.toString(response.getEntity()));
} catch (Exception e) {
e.printStackTrace();
}
}
|
|
| C#代码 |
注意处理HTTPS请求时的SSL证书验证，确保AppCode和URL正确性。 |
复 制 |
|
//using System.IO;
//using System.Text;
//using System.Net;
//using System.Net.Security;
//using System.Security.Cryptography.X509Certificates;
private const String host = "https://ocrimg.market.alicloudapi.com";
private const String path = "/ocr";
private const String method = "POST";
private const String appcode = "你自己的AppCode";
static void Main(string[] args)
{
String querys = "";
String bodys = "img=%2F9j%2F4AAQSkZJR***BAAD%2F4gI***&url=https%3A%2F%2Fwww.zpzzq.com%2Fimages%2Focrtest.jpg&ver=0";
String url = host + path;
HttpWebRequest httpRequest = null;
HttpWebResponse httpResponse = null;
if (0 < querys.Length)
{
url = url + "?" + querys;
}
if (host.Contains("https://"))
{
ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
httpRequest = (HttpWebRequest)WebRequest.CreateDefault(new Uri(url));
}
else
{
httpRequest = (HttpWebRequest)WebRequest.Create(url);
}
httpRequest.Method = method;
httpRequest.Headers.Add("Authorization", "APPCODE " + appcode);
//根据API的要求，定义相对应的Content-Type
httpRequest.ContentType = "application/x-www-form-urlencoded; charset=UTF-8";
if (0 < bodys.Length)
{
byte[] data = Encoding.UTF8.GetBytes(bodys);
using (Stream stream = httpRequest.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
}
try
{
httpResponse = (HttpWebResponse)httpRequest.GetResponse();
}
catch (WebException ex)
{
httpResponse = (HttpWebResponse)ex.Response;
}
Console.WriteLine(httpResponse.StatusCode);
Console.WriteLine(httpResponse.Method);
Console.WriteLine(httpResponse.Headers);
Stream st = httpResponse.GetResponseStream();
StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8"));
Console.WriteLine(reader.ReadToEnd());
Console.WriteLine("\n");
}
public static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
{
return true;
}
|
|
| Python代码 |
urllib2在Python 3中已被弃用，Python 3用户应使用urllib.request模块。 |
复 制 |
|
import urllib, urllib2, sys
import ssl
host = 'https://ocrimg.market.alicloudapi.com'
path = '/ocr'
method = 'POST'
appcode = '你自己的AppCode'
querys = ''
bodys = {}
url = host + path
bodys['img'] = '''/9j/4AAQSkZJR***BAAD/4gI***'''
bodys['url'] = '''https://www.zpzzq.com/images/ocrtest.jpg'''
bodys['ver'] = '''0'''
post_data = urllib.urlencode(bodys)
request = urllib2.Request(url, post_data)
request.add_header('Authorization', 'APPCODE ' + appcode)
//根据API的要求，定义相对应的Content-Type
request.add_header('Content-Type', 'application/x-www-form-urlencoded; charset=UTF-8')
ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE
response = urllib2.urlopen(request, context=ctx)
content = response.read()
if (content):
print(content)
|
|
| ObjectC代码 |
拼接URL时，?开头查询字符串可行。建议使用NSURLComponents。缓存策略按需设，超时时间可调。 |
复 制 |
|
NSString *appcode = @"你自己的AppCode";
NSString *host = @"https://ocrimg.market.alicloudapi.com";
NSString *path = @"/ocr";
NSString *method = @"POST";
NSString *querys = @"";
NSString *url = [NSString stringWithFormat:@"%@%@%@", host, path , querys];
NSString *bodys = @"img=%2F9j%2F4AAQSkZJR***BAAD%2F4gI***&url=https%3A%2F%2Fwww.zpzzq.com%2Fimages%2Focrtest.jpg&ver=0";
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString: url] cachePolicy:1 timeoutInterval: 5];
request.HTTPMethod = method;
[request addValue: [NSString stringWithFormat:@"APPCODE %@" , appcode] forHTTPHeaderField: @"Authorization"];
[request addValue: @"application/x-www-form-urlencoded; charset=UTF-8" forHTTPHeaderField: @"Content-Type"];
NSData *data = [bodys dataUsingEncoding: NSUTF8StringEncoding];
[request setHTTPBody: data];
NSURLSession *requestSession = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];
NSURLSessionDataTask *task = [requestSession dataTaskWithRequest:request
completionHandler:^(NSData * _Nullable body , NSURLResponse * _Nullable response, NSError * _Nullable error) {
NSLog(@"Response object: %@" , response);
NSString *bodyString = [[NSString alloc] initWithData:body encoding:NSUTF8StringEncoding];
//打印应答中的body
NSLog(@"Response body: %@" , bodyString);
}];
[task resume];
|
|
| curl代码 |
|
复 制 |
|
|
curl -i -k -X POST 'https://ocrimg.market.alicloudapi.com/ocr' -H 'Authorization:APPCODE 你自己的AppCode' --data 'img=%2F9j%2F4AAQSkZJR***BAAD%2F4gI***&url=https%3A%2F%2Fwww.zpzzq.com%2Fimages%2Focrtest.jpg&ver=0'
|
