me.chanjar.weixin.channel.api.WxFinderLiveService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of weixin-java-channel Show documentation

微信视频号/微信小店 Java SDK

There is a newer version: 4.7.1.B

package me.chanjar.weixin.channel.api;

import me.chanjar.weixin.channel.bean.lead.component.request.GetFinderLiveDataListRequest;
import me.chanjar.weixin.channel.bean.lead.component.request.GetFinderLiveLeadsDataRequest;
import me.chanjar.weixin.channel.bean.lead.component.response.FinderAttrResponse;
import me.chanjar.weixin.channel.bean.lead.component.response.GetFinderLiveDataListResponse;
import me.chanjar.weixin.channel.bean.lead.component.response.GetFinderLiveLeadsDataResponse;
import me.chanjar.weixin.common.error.WxErrorException;

/**
 * 视频号助手 留资服务的直播数据服务
 *
 * @author imyzt
 */
public interface WxFinderLiveService {

  /**
   * 获取视频号账号信息
   *
   * @return 视频号账号信息
   */
  FinderAttrResponse getFinderAttrByAppid() throws WxErrorException;

  /**
   * 获取留资直播间数据详情
   *
   * @param req 留资组件信息
   * @return 留资信息详情
   */
  GetFinderLiveDataListResponse getFinderLiveDataList(GetFinderLiveDataListRequest req) throws WxErrorException;

  /**
   * 获取账号收集的留资数量
   * 说明：该接口只统计2023.9.13号起的数据，所以start_time应大于等于1694534400
   *
   * @param req 留资组件信息
   * @return 留资信息列表
   */
  GetFinderLiveLeadsDataResponse getFinderLiveLeadsData(GetFinderLiveLeadsDataRequest req) throws WxErrorException;

}