句法分析API

目录

1. 接口描述

域名:wenzhi.api.qcloud.com
接口名: TextDependency
句法分析出句子中词与词之间的关系,可用于提取句子主干,提取句子核心词等。句法分析可以更好的理解句子,从而在机器翻译、自动问答、知识抽取等领域都可以应用。

2. 输入参数

参数名称 必选 类型 描述
content String 待分析的文本(只能为utf8编码)

3. 输出参数

参数名称 类型 描述
id Int 节点id
father_id Int 父节点id
dep_rel String SBV 主谓关系
VOB 动宾关系
IOB 间宾关系
FOB 前置宾语
DBL 兼语
ATT 定中关系
ADV 状中结构
CMP 动补结构
COO 并列关系
POB 介宾关系
LAD 左附加关系
RAD 右附加关系
IS 独立结构
HED 核心关系
postag String 词性
word String
code Int 0表示成功,非0表示失败
message String 失败时候的错误信息,成功则无该字段


句法分析API错误码详细信息如下:

错误码 含义说明
400 HTTP Method不正确
401 HTTP请求参数不符合要求
503 调用额度已超出限制
504 服务故障

4. 详细示例

示例业务详细信息如下表:

参数名称 参数描述 必选 参数值示例
腾讯云公共参数 Action 方法名 TextDependency
SecretId SecretId AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA
Timestamp 当前时间戳 1408704141
Nonce 随机正整数 345122
业务参数 content 待分析的文本(只能为utf8编码) 双万兆服务器就是好,只是内存小点


下面以上述业务为例,详细说明“句法分析API”接口的使用方法。

4.1 接口鉴权

示例要调用服务的数据为:{"content":"双万兆服务器就是好,只是内存小点"}
则上述业务的参数列表如下:

{
        'Action' : 'TextDependency',
        'Nonce' : 345122,
        'Region' : 'sz',
        'SecretId' : 'AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA',
        'Timestamp' : 1408704141,
        'content': '双万兆服务器就是好,只是内存小点'
    }

根据上述参数列表进行签名,得出的数字签名为:HgIYOPcx5lN6gz8JsCFBNAWp2oQ(示例),详细的数字签名的生成方法请参照:《腾讯云接口鉴权》。
注意
1)在生成签名的过程中,需要将加密字符串中包含的“_”改写成“.”,从而加密产生签名;
2)鉴权时,需要将参数列表按key进行排序:字典序,同时大写在前。

4.2 API调用

根据上一步(1.4.1)中得到的数字签名,以POST请求为例构造请求URL,将数字签名加入到参数Signature中。

https://wenzhi.api.qcloud.com/v2/index.php?
    Action=TextDependency
    &Nonce=345122
    &Region=sz
    &SecretId=AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA
    &Timestamp=1408704141
    &Signature=HgIYOPcx5lN6gz8JsCFBNAWp2oQ
    &content=双万兆服务器就是好,只是内存小点

执行上述操作之后,会将数据{"content":"双万兆服务器就是好,只是内存小点"}发送给API接口,进行相应分析。
注意:在发送请求过程中,不能将参数字符串中包含的“_”改写成“.”。
上述指令返回的数据结构如下:

 {
    "code": 0,
    "message": "",
    "keywords": [
        [
            {
                "dep_rel": "ATT",
                "father_id": 2,
                "id": 1,
                "postag": "m",
                "word": "双"
            },
            {
                "dep_rel": "ATT",
                "father_id": 3,
                "id": 2,
                "postag": "n",
                "word": "万兆"
            },
            {
                "dep_rel": "SBV",
                "father_id": 4,
                "id": 3,
                "postag": "n",
                "word": "服务器"
            },
            {
                "dep_rel": "HED",
                "father_id": 0,
                "id": 4,
                "postag": "v",
                "word": "就是"
            },
            {
                "dep_rel": "CMP",
                "father_id": 4,
                "id": 5,
                "postag": "a",
                "word": "好"
            },
            {
                "dep_rel": "WP",
                "father_id": 4,
                "id": 6,
                "postag": "w",
                "word": ","
            },
            {
                "dep_rel": "COO",
                "father_id": 4,
                "id": 7,
                "postag": "c",
                "word": "只是"
            },
            {
                "dep_rel": "ATT",
                "father_id": 9,
                "id": 8,
                "postag": "n",
                "word": "内存"
            },
            {
                "dep_rel": "VOB",
                "father_id": 7,
                "id": 9,
                "postag": "n",
                "word": "小点"
            }
        ]
    ]
}

以上信息是否解决您的问题?

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部