Python示例

请求接口地址

示例代码

# 需安装第三方requests
# img_url，图片存放路径
# 读取图片，并获取图片的base64数据
import base64,requests
api_post_url = "http://www.bingtop.com/ocr/upload/"
img_url = r'C:\images\图片地址.jpg'
with open(img_url,'rb') as pic_file:
    img64=base64.b64encode(pic_file.read())
params = {
    "username": "%s" % api_username,
    "password": "%s" % api_password,
    "captchaData": img64,
    "captchaType": 1001
}
response = requests.post(api_post_url, data=params)
dictdata=json.loads(response.text)
# dictdata: {"code":0, "message":"", "data":{"captchaId":"1001-158201918112812","recognition":"RESULT"}}

请求参数

{
    "username":"admin",
    "password":"123456",
    "captchaData":"/9j/4AAQ...示例省略若干位（图片文件内容的base64结果）...==",
    "captchaType":1001
}
  • username：注册用户名
  • password：登录密码
  • captchaData：图片文件内容，base64后的数据
  • captchaType：识别类型(整形)，，请查阅识别分类

响应数据

{"code":0, "message":"", "data":{"captchaId":"1001-158201918112812","recognition":"RESULT"}}
  • code：统一错误返回
  • message：统一错误信息返回，正常为空
  • data->captchaId：识别ID(非数字格式，预留40字节字符串长度)
  • data->recognition：识别结果

提示

  • 简单图，英文字母、数字直接返回。全部大写化处理。
  • 中文图，可能返回中文 或者返回 JSON标准的unicode \u4e2d\u6587 ，需要接入方使用标准JSON解析库自动处理。
  • 坐标图，返回 | 和 , 分割的相对图片左上角像素坐标， 100,102|200,202
  • 核心提示
    • 获取结果接口为长连接阻塞式，不需要轮询获取结果。此接口为长连接阻塞模式。正常情况下，此接口会阻塞HTTP请求，直至有识别结果返回。所以接入方发起HTTP请求时， 应当 将此接口的超时时间设置为 60秒 。
    • 为了防止网络问题导致长连接断开。接入方客户端应当在此接口没有返回任何 HTTP状态码 时（即网络故障），跳过本条，下次请求随机间隔 0.2 ~ 1.5 秒。
    • 如遇任何错误，例如用户密码错误、点数不足，重新上传时，必须间隔3秒以上，防止无意义的重试。否则服务器会认为恶意攻击封禁IP。