获取热问列表-开放接口

配置信息

例如:

  • APPID: xxxxxxxxxxxxxxx
  • TOKEN: xxxxxxxxxxxxxxx
  • EncodingAESKey: xxxxxxxxxxxxxxx

批量设置用户标签接口:

https://openai.weixin.qq.com/openapi/gethotquerylist/{TOKEN}

接口类型:

POST请求

参数说明:

字段 类型 是否必填 描述
pageNo number 分页参数,从1开始,默认为1
pageSize number 分页参数,默认为10
matchType number 命中类型, 枚举[0,1,2],全部0/命中:1/未命中:2
cluesType number 问题类型,枚举[0,1,2], 全部问题:0/交易相关:1/其他:2
reportType number 报告类型,枚举[0,1], 日报:0/周报:1
date string 日期,格式:“YYYY-mm-dd”, 当reportType 为周报时,应传周一的日期, 比如 :“2021-07-19”
openid string 开发者openid

开发者openid 获取办法:

  1. 第三方平台: https://developers.weixin.qq.com/doc/aispeech/openapi/api/v1/user_register.html
  2. 平台用户: TBD

消息加解密接入指引

比如参数为

<xml>
   <pageNo>1</pageNo>
   <pageSize>10</pageSize>
   <matchType>0</matchType>
   <cluesType>0</cluesType>
   <reportType>0</reportType>
   <date><![CDATA[2021-07-19]]></date>
   <openid><![CDATA[abcdasdf123123asldjfalsjdf]]></openid>
</xml>

将加密后的数据,以字段 encrypt 放入 body 中

var cryptor = new WXBizMsgCrypt(TOKEN, EncodingAESKey, APPID);

var data = `<xml>
   <pageNo>1</pageNo>
   <pageSize>10</pageSize>
   <matchType>0</matchType>
   <cluesType>0</cluesType>
   <reportType>0</reportType>
   <date><![CDATA[2021-07-19]></date>
</xml>

</xml>`

var encrypted = cryptor.encrypt(data);

curl -X post -d '{"encrypt": encrypted}' "https://openai.weixin.qq.com/openapi/gethotquerylist/{TOKEN}"

返回格式:

export type HotQuesRsp = {
    code: number;
    msg: string;
    data: {
        hotQuesClusterCount: number; // 问题类别数量
        hotQuesCount: number; // 问题数量
        totalPages: number; // 总页数
        list: [
            {
                askCount: number; // 提问总数,
                askUserCount: number; // 提问用户数
                quesCount: number; // 问法总数
                cluesType: string;
                exampleQues: [
                    {
                        ques: string; // 相似问题
                        score: number; // 分数
                    }
                ];
            }
        ];
    };
};

返回值说明:

字段 类型 描述
code number 错误码
msg array 接口调用信息
hotQuesClusterCount number 问题类别数量
hotQuesCount number 问题数量
totalPages number 总页数
askCount number 提问总数
askUserCount number 提问用户数
exampleQues number 相似问题