配置信息

例如:

APPID: xxxxxxxxxxxxxxx

TOKEN: xxxxxxxxxxxxxxx

EncodingAESKey: xxxxxxxxxxxxxxx

接口信息

对文本进行实时聚合。本文档提供聚合文本的上报接口。

文本实时聚合-上报接口(只签名不加密):

https://openai.weixin.qq.com/openapi/nlp/topk_insert/TOKEN

接口类型:

POST请求

参数说明:

字段 类型 默认值 描述
query string 使用JWT签名后的数据

query签名说明:

字段 类型 默认值 描述
uid string 自动生成的随机标识 用户标识的唯一ID,比如:openid
data Object {"text": "这是一条评论", "bucket": "xewrwex123", "meta": {"someinfokey": "someinfovalue"}}

使用JSON Web TokenHS256 算法对参数进行encode, 放入到query参数中

比如参数为

{
  uid: "xjlsj33lasfaf", //能标识用户的唯一用户id,可以是openid
  data: {
    text: "恭喜小张脱单成功",
    bucket: "xewrwex123", //房间ID,同一个bucket下的同义文本都会被尝试聚合。
    meta: {"response": "主播或机器人回复", "responded_by_bot": false, "responded_by_streamer": true} //其他信息,object.
  }
}

使用 jwt 和 EncodingAESKey 对数据对象进行encode得到加密字符串

const signedData = jwths256.encode(EncodingAESKey, {
      uid: "xjlsj33lasfaf", //能标识用户的唯一用户id,可以是openid
      data: {
        text: "恭喜小张脱单成功",
        bucket: "xewrwex123", //房间ID,同一个bucket下的同义评论都会被尝试聚合。
        meta: {"response": "主播或机器回复", "responded_by_bot": false, "responded_by_streamer": true} //其他信息,object.
      }
    }
)

调用开放平台语义接口

curl -XPOST -d "query=signedData" https://openai.weixin.qq.com/openapi/nlp/topk_insert/TOKEN

https://www.jsonwebtoken.io/

Tips: 在 jsonwebtoken.io 网站上可以参考如下步骤手动生成signedData 手动生成signedData示例

返回结果

  • text_id: 上报文本在聚合系统中的唯一id。
  • count: 上报文本在聚合系统中的计数(如存在语义相同的句子也会被一并计数)
{
    "xewrwex123_b0f00af4d24a8d9847594dd7c53ef7ae": 1
}