文档中心 > 步骤3:发送请求
步骤3:发送请求

最近更新时间:2021-03-12

本节以分词和词性标注为例,对一句话进行分词并标注词性。通过Token认证方式调用分词和词性标注的API请求。

1 请求说明

1.1 请求方式

调用地址:https://apim.unicloud.com/api/nlp/segment/1.0.0/

请求方式:POST

返回类型:JSON

1.2 请求参数

Header如下:

参数
Content-Typeapplication/json
AuthorizationBearer

Body如下:

参数是否必选类型可选值范围说明
texttruestring--待分析文本,长度建议不超过1000个汉字,超过上限接口报错

注:Body使用raw-json形式

1.3 请求示例

curl -H "Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3" 、
-H "Content-Type:application/json" 、
-d '{"text": "阳光保险集团股份有限公司于2005年7月成立"}' 、
https://apim.unicloud.com/api/nlp/segment/1.0.0/

注:发送请求时,Token请填写上面“步骤2:创建应用”后得到的Token

2 返回说明

2.1 返回参数

字段类型说明
datadict返回结果数据
+textstring待分析文本
+segmentarray of objects词汇数组,每个元素对应结果中的一个词
++wordstring词汇字符串
++offsetint词在原文的起始位置
++lengthint词长度
++posstring当前分词对应的词性
++basic_wordsarray of strings构成词的子部分
codeint返回码:
0表示成功
1001表示错误的命令请求格式:如JSON格式错误
2000 表示请求的操作超时终止:如模块处理超时
2001 表示未执行请求的操作:如文本超过指定长度
messagestring返回信息

2.2 返回示例

{    
    "data": {        
        "text": "阳光保险集团股份有限公司于2005年7月成立",        
        "segment": [
            {                
                "offset": 0,                
                "pos": "nt",                
                "basic_words": [                    
                    "阳光保险集团",                    
                    "股份有限公司"
                ],                
                "length": 12,                
                "word": "阳光保险集团股份有限公司"
            },
            {                
                "offset": 12,                
                "pos": "p",                
                "basic_words": [],                
                "length": 1,                
                "word": "于"
            },
            {                
                "offset": 13,                
                "pos": "t",                
                "basic_words": [                    
                    "2005",                    
                    "年",                    
                    "7月"
                ],                
                "length": 7,                
                "word": "2005年7月"
            },
            {                
                "offset": 20,                
                "pos": "v",                
                "basic_words": [],                
                "length": 2,                
                "word": "成立"
            }
        ]     
    },    
    "code": 0,    
    "message": 
    "success"
}

3 通过Postman发送请求示例

  • 请求方式:POST

  • 调用地址:https://apim.unicloud.com/api/nlp/segment/1.0.0/

  • Body选择raw-json格式,{"text": "阳光保险集团股份有限公司于2005年7月成立"}

  • Headers配置Content-Type:application/json 和 Authorization: Bearer Token值