WeixinJavaTools/weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/WxMpCommentService.java

package me.chanjar.weixin.mp.api;

import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.mp.bean.comment.WxMpCommentListVo;

/**
 * 图文消息留言管理接口.
 * https://developers.weixin.qq.com/doc/offiaccount/Comments_management/Image_Comments_Management_Interface.html
 *
 * @author <a href="https://github.com/binarywang">Binary Wang</a>
 * @date 2019-06-16
 */
public interface WxMpCommentService {
  /**
   * 打开已群发文章评论.
   * https://api.weixin.qq.com/cgi-bin/comment/open?access_token=ACCESS_TOKEN
   *
   * @param msgDataId 群发返回的msg_data_id
   * @param index     多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
   * @throws WxErrorException 异常
   */
  void open(String msgDataId, Integer index) throws WxErrorException;

  /**
   * 关闭已群发文章评论.
   * https://api.weixin.qq.com/cgi-bin/comment/close?access_token=ACCESS_TOKEN
   *
   * @param msgDataId 群发返回的msg_data_id
   * @param index     多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
   * @throws WxErrorException 异常
   */
  void close(String msgDataId, Integer index) throws WxErrorException;

  /**
   * 查看指定文章的评论数据.
   * https://api.weixin.qq.com/cgi-bin/comment/list?access_token=ACCESS_TOKEN
   *
   * @param msgDataId 群发返回的msg_data_id
   * @param index     多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
   * @param begin     起始位置
   * @param count     获取数目（>=50会被拒绝）
   * @param type      type=0 普通评论&精选评论 type=1 普通评论 type=2 精选评论
   * @return 评论列表数据
   * @throws WxErrorException 异常
   */
  WxMpCommentListVo list(String msgDataId, Integer index, int begin, int count, int type) throws WxErrorException;
}