精准搜索词条

将关键词与词条名、别名精准匹配，并返回对应的 词条 ID。

Error: 为了更好地提升接口文档的的易理解性，我们对文档进行了升级，请尽快迁移至新版本>>

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/baike/v1/entities/match
HTTP Method	POST
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	baike:entity 查看、创建、编辑、删除飞书词典词条 baike:entity:exempt_review 创建、更新飞书词典免审词条 baike:entity:readonly 查看飞书词典词条

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
word	string	是	搜索关键词，将与词条名、别名进行精准匹配 示例值："飞书词典" 数据校验规则： - 长度范围：1 ～ 100 字符

请求体示例

{
    "word": "飞书词典"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ results	match_info\[\]	搜索结果
└ entity_id	string	词条 ID
└ type	int	命中的字段 可选值有： - 0: 词条名 - 1: 全称 - 2: 别名

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "results": [
            {
                "entity_id": "enterprise_34***584",
                "type": 0
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1540001	invalid param	参数错误，参考文档检查输入参数
500	1540002	network anomaly, please try again	多数请求是服务超时，请重新请求，少数是服务异常请咨询客服