同义词API

目录

1. 接口描述

域名:wenzhi.api.qcloud.com
接口名: LexicalSynonym
为用户提供同义词查询服务,搜索团队通过全网数据挖掘出海量同义词,并持续对数据、模型等进行迭代更新,保证同义词的效果始终与时俱进。用户也可以通过提供产品专有的数据,与我们合作打造专属的同义词库。同义词服务作为搜索引擎检索串理解的基本功能,目前已经应用在视频、音乐、应用宝、群搜、商圈等数百个产品中。

2. 输入参数

参数名称 必选 类型 描述
text String 待分析的文本(目前文智统一输入为utf-8)

3. 输出参数

参数名称 类型 描述
code Int32 错误码, 0: 成功, 其他值: 失败
message String 错误信息,错误码详情参见错误码说明
query String 输入的原文本
syns Array 同义词分析结果,其中Array元素包括以下字段
word_ori Object 原词信息,包含以下字段
idx_beg Int32 起始位置
idx_end Int32 终止位置
text String 提取的原词文本
word_syns Array 原词对应的同义词列表,其中Array元素包含
text String 同义词文本
conf Double 同义词置信度


同义词API错误码详细信息如下:

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

4. 详细示例

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

参数名称 参数描述 必选 参数值示例
腾讯云公共参数 Action 方法名 LexicalSynonym
SecretId SecretId AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA
Timestamp 当前时间戳 1408704141
Nonce 随机正整数 345122
业务参数 text 待分析的文本(目前文智统一输入为utf-8) 周杰伦结婚


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

4.1 接口鉴权

示例要调用服务的数据为:{"text":"周杰伦结婚"}
则上述业务的参数列表如下:

{
        'Action' : 'LexicalSynonym',
        'Nonce' : 345122,
        'Region' : 'sz',
        'SecretId' : 'AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA',
        'Timestamp' : 1408704141,
        'text': '周杰伦结婚'
    }

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

4.2 API调用

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

https://wenzhi.api.qcloud.com/v2/index.php?
    Action=LexicalSynonym
    &Nonce=345122
    &Region=sz
    &SecretId=AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA
    &Timestamp=1408704141
    &Signature=HgIYOPcx5lN6gz8JsCFBNAWp2oQ
    &text=周杰伦结婚

执行上述操作之后,会将数据{"text":"周杰伦结婚"}发送给API接口,进行相应分析。
注意:在发送请求过程中,不能将参数字符串中包含的“_”改写成“.”。
上述指令返回的数据结构如下:

{
        "code": 0,
        "message": "",
        "syns": [
            {
                "word_ori": {
                    "idx_beg": 0,
                    "idx_end": 2,
                    "text": "周杰伦"
                },
                "word_syns": [
                    {
                        "conf": 0.2000000029802322,
                        "text": "jay"
                    },
                    {
                        "conf": 0.2000000029802322,
                        "text": "周董"
                    }
                ]
            }
        ]
    }

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

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部