openapi/v1: 表情表态api SDK (merge request !30)

Squash merge branch 'feature_20220221_reactionapi_story_872022587' into 'master'
openapi/v1: 表情表态api SDK

--story=872022051


TAPD: --story=872022051

Author: kamichen-tencent

examples/apitest/message_reaction_test.go

@@ -0,0 +1,28 @@
+package apitest
+
+import (
+	"testing"
+
+	"github.com/tencent-connect/botgo/dto"
+)
+
+func TestMessageReaction(t *testing.T) {
+	t.Run(
+		"Create Message Reaction", func(t *testing.T) {
+			err := api.CreateMessageReaction(ctx, testChannelID, testMessageID, dto.Emoji{Type: 1, ID: "43"})
+			if err != nil {
+				t.Error(err)
+			}
+			t.Logf("err:%+v", err)
+		},
+	)
+	t.Run(
+		"Delete Own Reaction", func(t *testing.T) {
+			err := api.DeleteOwnMessageReaction(ctx, testChannelID, testMessageID, dto.Emoji{Type: 1, ID: "43"})
+			if err != nil {
+				t.Error(err)
+			}
+			t.Logf("err:%+v", err)
+		},
+	)
+}

openapi/iface.go

@@ -24,6 +24,7 @@ type OpenAPI interface {
 	AnnouncesAPI
 	ScheduleAPI
 	APIPermissionsAPI
+	MessageReactionAPI
 }
 
 // Base 基础能力接口
@@ -178,3 +179,11 @@ type APIPermissionsAPI interface {
 	RequireAPIPermissions(ctx context.Context,
 		guildID string, demand *dto.APIPermissionDemandToCreate) (*dto.APIPermissionDemand, error)
 }
+
+// MessageReactionAPI 消息表情表态接口
+type MessageReactionAPI interface {
+	// CreateMessageReaction 对消息发表表情表态
+	CreateMessageReaction(ctx context.Context, channelID, messageID string, emoji dto.Emoji) error
+	// DeleteOwnMessageReaction 删除自己的消息表情表态
+	DeleteOwnMessageReaction(ctx context.Context, channelID, messageID string, emoji dto.Emoji) error
+}

openapi/v1/message_reaction.go

@@ -0,0 +1,38 @@
+package v1
+
+import (
+	"context"
+	"strconv"
+
+	"github.com/tencent-connect/botgo/dto"
+)
+
+// CreateMessageReaction 对消息发表表情表态
+func (o *openAPI) CreateMessageReaction(ctx context.Context,
+	channelID, messageID string, emoji dto.Emoji) error {
+	_, err := o.request(ctx).
+		SetPathParam("channel_id", channelID).
+		SetPathParam("message_id", messageID).
+		SetPathParam("emoji_type", strconv.FormatUint(uint64(emoji.Type), 10)).
+		SetPathParam("emoji_id", emoji.ID).
+		Put(o.getURL(messageReactionURI))
+	if err != nil {
+		return err
+	}
+	return nil
+}
+
+// DeleteOwnMessageReaction 删除自己的消息表情表态
+func (o *openAPI) DeleteOwnMessageReaction(ctx context.Context,
+	channelID, messageID string, emoji dto.Emoji) error {
+	_, err := o.request(ctx).
+		SetPathParam("channel_id", channelID).
+		SetPathParam("message_id", messageID).
+		SetPathParam("emoji_type", strconv.FormatUint(uint64(emoji.Type), 10)).
+		SetPathParam("emoji_id", emoji.ID).
+		Delete(o.getURL(messageReactionURI))
+	if err != nil {
+		return err
+	}
+	return nil
+}

openapi/v1/resource.go

@@ -56,6 +56,8 @@ const (
 
 	apiPermissionURI       uri = "/guilds/{guild_id}/api_permission"
 	apiPermissionDemandURI uri = "/guilds/{guild_id}/api_permission/demand"
+
+	messageReactionURI uri = "/channels/{channel_id}/messages/{message_id}/reactions/{emoji_type}/{emoji_id}"
 )
 
 // getURL 获取接口地址，会处理沙箱环境判断