1
0
Fork 0
mirror of https://github.com/diamondburned/arikawa.git synced 2024-12-11 16:05:00 +00:00
arikawa/api/emoji.go

89 lines
3.1 KiB
Go
Raw Normal View History

2020-01-02 05:39:52 +00:00
package api
import (
2020-10-28 22:39:59 +00:00
"github.com/diamondburned/arikawa/v2/discord"
"github.com/diamondburned/arikawa/v2/utils/httputil"
2020-01-02 05:39:52 +00:00
)
2020-05-14 07:49:57 +00:00
// Emoji is the API format of a regular Emoji, both Unicode or custom. This
// could usually be formatted by calling (discord.Emoji).APIString().
2020-05-11 19:03:33 +00:00
type Emoji = string
2020-01-02 05:39:52 +00:00
2020-05-12 00:17:45 +00:00
// NewCustomEmoji creates a new Emoji using a custom guild emoji as
2020-05-11 19:03:33 +00:00
// base.
// Unicode emojis should be directly passed to the function using Emoji.
func NewCustomEmoji(id discord.EmojiID, name string) Emoji {
2020-03-22 22:23:29 +00:00
return name + ":" + id.String()
2020-01-02 05:39:52 +00:00
}
2020-05-11 22:06:19 +00:00
// Emojis returns a list of emoji objects for the given guild.
func (c *Client) Emojis(guildID discord.GuildID) ([]discord.Emoji, error) {
var e []discord.Emoji
return e, c.RequestJSON(&e, "GET", EndpointGuilds+guildID.String()+"/emojis")
2020-01-02 05:39:52 +00:00
}
2020-05-11 22:06:19 +00:00
// Emoji returns an emoji object for the given guild and emoji IDs.
func (c *Client) Emoji(guildID discord.GuildID, emojiID discord.EmojiID) (*discord.Emoji, error) {
var emj *discord.Emoji
return emj, c.RequestJSON(&emj, "GET",
EndpointGuilds+guildID.String()+"/emojis/"+emojiID.String())
2020-01-02 05:39:52 +00:00
}
2020-05-11 22:06:19 +00:00
// https://discord.com/developers/docs/resources/emoji#create-guild-emoji-json-params
type CreateEmojiData struct {
// Name is the name of the emoji.
Name string `json:"name"`
// Image is the the 128x128 emoji image.
Image Image `json:"image"`
// Roles are the roles for which this emoji will be whitelisted.
Roles *[]discord.RoleID `json:"roles,omitempty"`
2020-05-11 22:06:19 +00:00
}
2020-01-04 04:19:24 +00:00
// CreateEmoji creates a new emoji in the guild. This endpoint requires
// MANAGE_EMOJIS. ContentType must be "image/jpeg", "image/png", or
// "image/gif". However, ContentType can also be automatically detected
2020-05-11 22:06:19 +00:00
// (though shouldn't be relied on).
// Emojis and animated emojis have a maximum file size of 256kb.
func (c *Client) CreateEmoji(guildID discord.GuildID, data CreateEmojiData) (*discord.Emoji, error) {
2020-01-04 04:19:24 +00:00
2020-05-07 21:29:46 +00:00
// Max 256KB
2020-05-11 22:06:19 +00:00
if err := data.Image.Validate(256 * 1000); err != nil {
2020-01-04 04:19:24 +00:00
return nil, err
}
var emj *discord.Emoji
return emj, c.RequestJSON(
&emj, "POST",
EndpointGuilds+guildID.String()+"/emojis",
2020-05-11 22:06:19 +00:00
httputil.WithJSONBody(data),
2020-01-04 04:19:24 +00:00
)
}
2020-05-11 22:06:19 +00:00
// https://discord.com/developers/docs/resources/emoji#modify-guild-emoji-json-params
type ModifyEmojiData struct {
// Name is the name of the emoji.
Name string `json:"name,omitempty"`
// Roles are the roles to which this emoji will be whitelisted.
Roles *[]discord.RoleID `json:"roles,omitempty"`
2020-05-11 22:06:19 +00:00
}
2020-01-04 04:19:24 +00:00
// ModifyEmoji changes an existing emoji. This requires MANAGE_EMOJIS. Name and
// roles are optional fields (though you'd want to change either though).
2020-05-11 22:06:19 +00:00
//
// Fires a Guild Emojis Update Gateway event.
func (c *Client) ModifyEmoji(guildID discord.GuildID, emojiID discord.EmojiID, data ModifyEmojiData) error {
2020-01-04 04:19:24 +00:00
return c.FastRequest(
"PATCH",
EndpointGuilds+guildID.String()+"/emojis/"+emojiID.String(),
2020-05-11 22:06:19 +00:00
httputil.WithJSONBody(data),
2020-01-04 04:19:24 +00:00
)
}
2020-05-11 22:06:19 +00:00
// Delete the given emoji.
//
// Requires the MANAGE_EMOJIS permission.
// Fires a Guild Emojis Update Gateway event.
func (c *Client) DeleteEmoji(guildID discord.GuildID, emojiID discord.EmojiID) error {
2020-05-11 22:06:19 +00:00
return c.FastRequest("DELETE", EndpointGuilds+guildID.String()+"/emojis/"+emojiID.String())
2020-01-04 04:19:24 +00:00
}