# 命名实体识别对文本进行命名实体识别分析。 >目前支持人名、地名、时间、组织机构类实体的识别。 ## 请求格式说明 ** 调试工具：** 在线调试

请求方式：POST (HTTPS)

请求地址：

https://open.welink.huaweicloud.com/api/aiservice/v1/nlp/ner

认证方式： access_token，请参考获取access_token

请求头部：

Content-Type: application/json
x-wlk-Authorization: access_token

请求参数：

{ 
    "text":"昨天程序员李小明来到北京参加开发者大赛，在比赛中表现优异，赢得了第一名。",
    "lang":"zh"
}

请求参数说明：

参数	必选	参数类型	说明
text	是	String	待分词文本，长度为1~512，文本编码为UTF-8。
lang	否	String	支持的文本语言类型，目前只支持中文，默认为zh。

请求示例：

 curl -X POST \
  'https://open.welink.huaweicloud.com/api/aiservice/v1/nlp/ner' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{"text":"昨天程序员李小明来到北京参加开发者大赛，在比赛中表现优异，赢得了第一名。","lang":"zh"}'

响应格式说明

返回结果

正常返回结果

{
    "code": "0",
    "data": {
        "named_entities": [
            {
                "word": "昨天",
                "tag": "t",
                "offset": 0,
                "len": 2
            },
            {
                "word": "李小明",
                "tag": "nr",
                "offset": 5,
                "len": 3
            },
            {
                "word": "北京",
                "tag": "ns",
                "offset": 10,
                "len": 2
            }
        ]
    },
    "error": "",
    "message": "ok"
}

异常返回结果

命名体识别失败响应示例

{
    "code": "58002",
    "data": null,
    "error": "argument valid error:text.must not be blank;text.text for segment should between 1 and 512;",
    "message": "NLP service call exception"
}

Token验证失败响应示例

{
    "code": "58401",
    "data": null,
    "error": "Failed to verify the token.",
    "message": "Login authentication failed."
}

返回参数说明

参数	必选	参数类型	说明
code	是	String	错误码
message	是	String	调用成功时为"ok"。调用失败时的错误信息。
data	是	Object	调用成功时表示调用结果，详见data数据结构。调用失败时为null。
error	是	String	错误信息。

data 数据结构

参数	必选	参数类型	说明
named_entities	是	Array [named_entity]	命名实体识别结果。请参见named_entity数据结构说明。

named_entity 数据结构

参数	必选	参数类型	说明
word	是	String	实体文本。
tag	是	String	实体类型，枚举类型，支持人名nr，地名ns，机构名nt，时间t。
offset	是	Integer	实体文本在待分析文本中的起始位置。
len	是	Integer	实体文本长度。

错误码说明

错误码	说明
0	成功。
58401	无权限。
58402	非法参数异常。
58500	服务异常。
58002	NLP服务异常。

响应格式说明

结果。 ""

无结果。 ""