识别文件中的名片

名片识别接口，通过上传 JPG / PNG / PDF 等文件类型进行一次性的名片识别。接口适用于20MB以下的文件，适用于英文、日语的名片。

Tip: 单租户限流：10QPS，同租户下的应用没有限流，共享本租户的 10QPS 限流

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/document_ai/v1/business_card/recognize
HTTP Method	POST
接口频率限制	10 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	document_ai:business_card:recognize 识别名片

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	示例值："multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

请求体

名称	类型	必填	描述
file	file	是	识别名片的源文件（支持 JPG / PNG / PDF） 示例值：file binary

请求体示例

---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file";
Content-Type: application/octet-stream


---7MA4YWxkTrZu0gW

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ business_cards	recognized_entities\[\]	名片信息
└ entities	recognized_entity\[\]	识别的实体列表
└ type	string	识别的字段种类 可选值有： - contact_names: 联系人名 - company_names: 公司名 - departments: 部门 - job_titles: 职位 - emails: 邮箱 - websites: 网站 - addresses: 地址 - mobile_phones: 移动电话 - work_phones: 工作电话 - other_phones: 其他电话 - faxes: 传真
└ value	string	识别出字段的文本信息

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "business_cards": [
            {
                "entities": [
                    {
                        "type": "contact_names",
                        "value": "张三"
                    }
                ]
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	2110001	Invalid file	输入文件错误，参考文档检查输入参数
400	2110002	No business card detected.	未检测出名片信息，参考文档检查输入文件是否有效
500	2110010	Network anomaly, please try again.	后端服务异常或网络异常，可重新请求
400	2110003	You have reached the Intelligent document parsing limit. To continue using this function, please contact sales to purchase more.	智能文档解析次数已达使用上限，如需继续使用，请联系销售购买