openapi/v1: 撤回消息增加是否显示小灰条的选项 (merge request !38)

Squash merge branch 'feature_20220311_anezhou_deletemsgtips_story_872426353' into 'master'
openapi/v1: 撤回消息增加是否显示小灰条的选项

--story=872426353


TAPD: --story=872426353

Author: anezhou

examples/apitest/message_test.go

@@ -4,6 +4,7 @@ import (
 	"testing"
 
 	"github.com/tencent-connect/botgo/dto"
+	"github.com/tencent-connect/botgo/openapi"
 )
 
 func TestMessage(t *testing.T) {
@@ -87,7 +88,7 @@ func TestRetractMessage(t *testing.T) {
 	msgID := "109b8a401a1231343431313532313831383136323933383420801e28003081b0f30338cd6040c36048f5e4908e0650b1acf8fa05"
 	t.Run(
 		"消息撤回", func(t *testing.T) {
-			err := api.RetractMessage(ctx, "1049883", msgID)
+			err := api.RetractMessage(ctx, "1049883", msgID, openapi.RetractMessageOptionHidetip)
 			if err != nil {
 				t.Error(err)
 			}

openapi/iface.go

@@ -8,6 +8,14 @@ import (
 	"github.com/tencent-connect/botgo/token"
 )
 
+// RetractMessageOption 撤回消息可选参数
+type RetractMessageOption int
+
+const (
+	// RetractMessageOptionHidetip 撤回消息隐藏小灰条可选参数
+	RetractMessageOptionHidetip RetractMessageOption = 1
+)
+
 // OpenAPI openapi 完整实现
 type OpenAPI interface {
 	Base
@@ -58,7 +66,7 @@ type MessageAPI interface {
 	PostMessage(ctx context.Context, channelID string, msg *dto.MessageToCreate) (*dto.Message, error)
 	PatchMessage(ctx context.Context,
 		channelID string, messageID string, msg *dto.MessageToCreate) (*dto.Message, error)
-	RetractMessage(ctx context.Context, channelID, msgID string) error
+	RetractMessage(ctx context.Context, channelID, msgID string, options ...RetractMessageOption) error
 }
 
 // GuildAPI guild 相关接口
@@ -135,7 +143,7 @@ type DirectMessageAPI interface {
 	// PostDirectMessage 在私信频道内发消息
 	PostDirectMessage(ctx context.Context, dm *dto.DirectMessage, msg *dto.MessageToCreate) (*dto.Message, error)
 	// RetractDMMessage 撤回私信频道消息
-	RetractDMMessage(ctx context.Context, guildID, msgID string) error
+	RetractDMMessage(ctx context.Context, guildID, msgID string, options ...RetractMessageOption) error
 }
 
 // AnnouncesAPI 公告相关接口

openapi/v1/direct_message.go

@@ -4,6 +4,7 @@ import (
 	"context"
 
 	"github.com/tencent-connect/botgo/dto"
+	"github.com/tencent-connect/botgo/openapi"
 )
 
 // CreateDirectMessage 创建私信频道
@@ -33,10 +34,16 @@ func (o *openAPI) PostDirectMessage(ctx context.Context,
 }
 
 // RetractDMMessage 撤回私信消息
-func (o *openAPI) RetractDMMessage(ctx context.Context, guildID, msgID string) error {
-	_, err := o.request(ctx).
+func (o *openAPI) RetractDMMessage(ctx context.Context,
+	guildID, msgID string, options ...openapi.RetractMessageOption) error {
+	request := o.request(ctx).
 		SetPathParam("guild_id", guildID).
-		SetPathParam("message_id", string(msgID)).
-		Delete(o.getURL(dmsMessageURI))
+		SetPathParam("message_id", string(msgID))
+	for _, option := range options {
+		if option == openapi.RetractMessageOptionHidetip {
+			request = request.SetQueryParam("hidetip", "true")
+		}
+	}
+	_, err := request.Delete(o.getURL(dmsMessageURI))
 	return err
 }

openapi/v1/message.go

@@ -6,6 +6,7 @@ import (
 
 	"github.com/tencent-connect/botgo/dto"
 	"github.com/tencent-connect/botgo/errs"
+	"github.com/tencent-connect/botgo/openapi"
 )
 
 // Message 拉取单条消息
@@ -74,10 +75,16 @@ func (o *openAPI) PatchMessage(ctx context.Context,
 }
 
 // RetractMessage 撤回消息
-func (o *openAPI) RetractMessage(ctx context.Context, channelID, msgID string) error {
-	_, err := o.request(ctx).
+func (o *openAPI) RetractMessage(ctx context.Context,
+	channelID, msgID string, options ...openapi.RetractMessageOption) error {
+	request := o.request(ctx).
 		SetPathParam("channel_id", channelID).
-		SetPathParam("message_id", string(msgID)).
-		Delete(o.getURL(messageURI))
+		SetPathParam("message_id", string(msgID))
+	for _, option := range options {
+		if option == openapi.RetractMessageOptionHidetip {
+			request = request.SetQueryParam("hidetip", "true")
+		}
+	}
+	_, err := request.Delete(o.getURL(messageURI))
 	return err
 }