关键词提取API

目录

1. 接口描述

域名:wenzhi.api.qcloud.com
接口名: TextKeywords
基于关键词抽取平台, 为用户实现诸如新闻内容关键词自动提取、评论关键词提取等提供基础服务。支持用户自定义词典,提高在垂直领域的抽取效果。目前已经接入的业务包括腾讯新闻客户端、手机腾讯网等。

2. 输入参数

参数名称 必选 类型 描述
title String 新闻标题
channel String 新闻频道(选填 不填默认是科技)
CHnews_news_sports 体育新闻
CHnews_news_ent 娱乐新闻
CHnews_news_astro 星座新闻
CHnews_news_auto 汽车新闻
CHnews_news_cul 文化新闻
CHnews_news_digi 数码新闻
CHnews_news_finance 财经新闻
CHnews_news_game 游戏新闻
CHnews_news_house 房产新闻
CHnews_news_lad 时尚新闻
CHnews_news_mil 军事新闻
CHnews_news_ssh 社会新闻
CHnews_news_tech 科技新闻
CHnews_news_others 其它
content String 新闻正文

3. 输出参数

参数名称 类型 参数描述
code Int32 错误码, 0: 成功, 其他值: 失败
message String 错误信息,错误码详情参见错误码说明
keywords rray 关键词提取结果,其中Array元素包含以下字段
score Double 关键词权重
keyword String 关键词提取服务对文本标记的标签
type String keyword 文本中出现的关键词
topic 话题


关键词提取API错误码详细信息如下:

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

4. 详细示例

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

参数名称 参数描述 必选 参数值示例
腾讯云公共参数 Action 方法名 TextKeywords
SecretId SecretId AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA
Timestamp 当前时间戳 1408704141
Nonce 随机正整数 345122
业务参数 title 新闻标题 Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330
channel 新闻频道(选填 不填默认是科技)
content 新闻正文 Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330


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

4.1 接口鉴权

示例要调用服务的数据为:{"title":"Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330","content":"Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330"}
则上述业务的参数列表如下:

{
        'Action' : 'TextKeywords',
        'Nonce' : 345122,
        'Region' : 'sz',
        'SecretId' : 'AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA',
        'Timestamp' : 1408704141,
        'title': 'Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330',
        'content': 'Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330'
    }

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

4.2 API调用

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

  https://wenzhi.api.qcloud.com/v2/index.php?
    Action=TextKeywords
    &Nonce=345122
    &Region=sz
    &SecretId=AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA
    &Timestamp=1408704141
    &Signature=HgIYOPcx5lN6gz8JsCFBNAWp2oQ
    &title=Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330
    &content=Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330

执行上述操作之后,会将数据{"title":"Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330","content":"Dior新款,秋冬新款娃娃款甜美圆领配毛领毛呢大衣外套、码数:SM、P330"}发送给API接口,进行相应分析。
注意:在发送请求过程中,不能将参数字符串中包含的“_”改写成“.”。
上述指令返回的数据结构如下:

 {
        "code": 0,
        "message": "",
        "keywords": [
            {
                "keyword": "p330",
                "score": 0.2800000011920929,
                "type": "keyword"
            },
            {
                "keyword": "dior",
                "score": 0.2784992158412933,
                "type": "keyword"
            },
            {
                "keyword": "毛领",
                "score": 0.2746416926383972,
                "type": "keyword"
            }
        ]
    }

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

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部