Note:
名片识别接口全面升级，算法更强、性能更优，支持子账号调用。欢迎立即体验 新版名片识别。
新老版本的接口计费模式相同，且共享计费阶梯和资源包，您可以在【文字识别控制台】>【用量统计】中查看调用情况。
老版本接口我们仍继续维护，但不支持新客户开通调用，建议您使用 新版名片识别，体验更优服务。
接口描述
接口请求域名：
https://recognition.image.myqcloud.com/ocr/businesscard
本接口（businesscard）用于根据用户上传的名片图片，返回识别出的20多个字段信息，详细字段包括：姓名、英文姓名、职位、英文职位、部门、英文部门、公司、英文公司、地址、英文地址、邮编、邮箱、网址、手机、电话、传真、MSN、QQ、微信、微博、公司账号、logo、其他。本接口支持 HTTPS 协议，如果您现在使用的是 HTTP 协议，为了保障您的数据安全，请切换至 HTTPS。
如果开发者使用的是 V1 版本，为获得更优体验，请及时切换到 新版名片识别。
请求头 header
参数名 | 必选 | 值 | 描述 |
host | 是 | recognition.image.myqcloud.com | 腾讯云文字识别服务器域名。 |
content-length | 否 | 包体总长度 | 每个请求的包体大小限制为6MB，不支持 .gif 类型的动图。 |
content-type | 是 | application/json 或者 multipart/form-data | 根据不同接口选择： 1. 使用 application/json 格式，参数为 url ，其值为图片链接。 2. 使用 multipart/form-data 格式，参数为 image，其值为图片的二进制内容。 |
authorization | 是 | 鉴权签名 |
Note:
如选择 multipart/form-data，请使用 HTTP 框架/库推荐的方式设置请求的 content-type，不推荐直接调用 setheader 等方法设置，否则可能导致 boundary 缺失引起请求失败。
输入参数
输出参数
字段 | 类型 | 说明 |
result_list | JSON 数组 | 具体查询数据，内容见下表。 |
result_list（JSON 数组）中每一项的具体内容：
字段 | 类型 | 说明 |
code | Int | 服务器错误码，0为成功。 |
message | string | 服务器返回的信息。 |
url | String | 请求参数选择 url，则返回当前图片的 url。 |
filename | String | 请求参数选择 image，当前图片的 filname。 |
data | Array(item) | 具体查询数据，内容见下表。 |
data 字段具体内容：
字段 | 类型 | 说明 |
item | String | 字段字符串 |
value | String | 字段识别出来的信息 |
confidence | Double | 字段识别出来的信息的置信度，取值范围[0,1] |
示例
输入示例
使用 application/json
POST /ocr/businesscard HTTP/1.1Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==Host: recognition.image.myqcloud.comContent-Length: 187Content-Type: application/json{"appid":"123456","bucket":"test","url_list":["http://yoututest-1251966477.cossh.myqcloud.com/mingpian.jpg"]}
使用 multipart/form-data
POST /ocr/businesscard HTTP/1.1Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==Host: recognition.image.myqcloud.comContent-Length: 735Content-Type: multipart/form-data;boundary=--------------acebdf13572468----------------acebdf13572468Content-Disposition: form-data; name="appid";123456----------------acebdf13572468Content-Disposition: form-data; name="bucket";test----------------acebdf13572468Content-Disposition: form-data; name="image"; filename="mingpian.jpg"Content-Type: image/jpegxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx----------------acebdf13572468--
输出示例
{"result_list": [{"code": 0,"message": "OK","filename": "名片2.jpg","data": [{"item": "姓名","value": "温星涛","confidence": 0.9994000196456908},{"item": "职位","value": "解决方案高级架构师","confidence": 0.9758999943733216},{"item": "部门","value": "云产品部","confidence": 0.9998999834060668},{"item": "公司","value": "Tencent腾讯","confidence": 0.8555999994277954},{"item": "地址","value": "成都市高新区天府三街198号腾讯成都大厦A座1层610041","confidence": 0.5228000283241272},{"item": "邮箱","value": "timwen@tencent.com","confidence": 0.9995999932289124},{"item": "手机","value": "+86-18109023170","confidence": 0.9914000034332277},{"item": "电话","value": "9761758","confidence": 0.9998999834060668},{"item": "电话","value": "+86-28-85225111转51468","confidence": 0.9078999757766724},{"item": "传真","value": "+86-28-85980512","confidence": 0.9944000244140624}]}]}
错误码
错误码 | 含义 |
3 | 错误的请求；当 "message" 字段等于 “account abnormal,errorno is：2”时，表示账号欠费停服 |
4 | 签名为空 |
5 | 签名串错误 |
6 | 签名中的 appid/bucket 与操作目标不匹配 |
9 | 签名过期 |
10 | appid 不存在 |
11 | secretid 不存在 |
12 | appid 和 secretid 不匹配 |
13 | 重放攻击 |
14 | 签名校验失败 |
15 | 操作太频繁，触发频控 |
16 | Bucket不存在 |
21 | 无效参数 |
23 | 请求包体过大 |
24 | 没有权限 |
25 | 您购买的资源已用完 |
107 | 鉴权服务内部错误 |
108 | 鉴权服务不可用 |
213 | 内部错误 |
-1102 | 图片解码失败 |
-1300 | 图片为空 |
-1301 | 参数为空 |
-1304 | 参数过长 |
-1308 | 图片下载失败 |
-5201 | 名片无足够的文本 |
-5202 | 名片文本行倾斜角度太大 |
-5203 | 名片模糊 |
-5204 | 名片姓名识别失败 |
-5205 | 名片电话识别失败 |
-5206 | 上传图像不是名片 |
-5207 | 检测或者识别失败 |
-5208 | 名片 OCR 服务内部出错 |
