本文介绍名片识别RecognizeBusinessCard的语法及示例。

功能描述

名片识别能力可以识别各类名片关键字段内容,包括:姓名、职位、公司、部门、座机号、手机号、地址、邮箱共8个关键字段信息。

前提条件

请确保您已开通文字识别服务,若未开通服务请立即开通

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP、GIF。
  • 图像大小:不超过3 MB。
  • 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
  • 名片完整且占据图像的60%以上,角度正向且文字清晰。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizeBusinessCard

系统规定参数。取值:RecognizeBusinessCard

ImageURL String http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeBusinessCard/RecognizeBusinessCard1.jpg

图像URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
RequestId String 0068957A-C493-481F-BA14-C3F89BF75BD4

请求ID。

Data Object

返回的数据内容。

Companies Array of String 美丽广告有限公司

名片上的公司名称,可能为空。

Titles Array of String 设计经理

名片上的职位名称,可能为空。

Emails Array of String meili@123.com

名片上的邮箱地址,可能为空。

Departments Array of String 设计部

名片上的部门名称,可能为空。

OfficePhoneNumbers Array of String 02188888888

名片上的座机号码,可能为空。

Name String 孙梦

名片上的姓名。

CellPhoneNumbers Array of String 13900001234

名片上的手机号码,可能为空。

Addresses Array of String 杭州市西湖区湖滨123号

名片上的地址,可能为空。

示例

请求示例

http(s)://[Endpoint]/?Action=RecognizeBusinessCard
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeBusinessCard/RecognizeBusinessCard1.jpg
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RecognizeBusinessCardResponse>
    <RequestId>0068957A-C493-481F-BA14-C3F89BF75BD4</RequestId>
    <Data>
        <Companies>美丽广告有限公司</Companies>
        <Titles>设计经理</Titles>
        <Emails>meili@123.com</Emails>
        <Departments>设计部</Departments>
        <OfficePhoneNumbers>02188888888</OfficePhoneNumbers>
        <Name>孙梦</Name>
        <CellPhoneNumbers>13900001234</CellPhoneNumbers>
        <Addresses>杭州市西湖区湖滨123号</Addresses>
    </Data>
</RecognizeBusinessCardResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0068957A-C493-481F-BA14-C3F89BF75BD4",
  "Data" : {
    "Companies" : [ "美丽广告有限公司" ],
    "Titles" : [ "设计经理" ],
    "Emails" : [ "meili@123.com" ],
    "Departments" : [ "设计部" ],
    "OfficePhoneNumbers" : [ "02188888888" ],
    "Name" : "孙梦",
    "CellPhoneNumbers" : [ "13900001234" ],
    "Addresses" : [ "杭州市西湖区湖滨123号" ]
  }
}

错误码

关于名片识别的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。