package api import ( "github.com/diamondburned/arikawa/discord" "github.com/diamondburned/arikawa/utils/httputil" "github.com/diamondburned/arikawa/utils/json/option" ) var EndpointWebhooks = Endpoint + "webhooks/" // https://discord.com/developers/docs/resources/webhook#create-webhook-json-params type CreateWebhookData struct { // Name is the name of the webhook (1-80 characters). Name string `json:"name"` // Avatar is the image for the default webhook avatar. Avatar *Image `json:"avatar"` } // CreateWebhook creates a new webhook. // // Webhooks cannot be named "clyde". // // Requires the MANAGE_WEBHOOKS permission. func (c *Client) CreateWebhook( channelID discord.Snowflake, name string, avatar discord.Hash) (*discord.Webhook, error) { var param struct { Name string `json:"name"` Avatar discord.Hash `json:"avatar"` } param.Name = name param.Avatar = avatar var w *discord.Webhook return w, c.RequestJSON( &w, "POST", EndpointChannels+channelID.String()+"/webhooks", httputil.WithJSONBody(param), ) } // ChannelWebhooks returns the webhooks of the channel with the given ID. // // Requires the MANAGE_WEBHOOKS permission. func (c *Client) ChannelWebhooks(channelID discord.Snowflake) ([]discord.Webhook, error) { var ws []discord.Webhook return ws, c.RequestJSON(&ws, "GET", EndpointChannels+channelID.String()+"/webhooks") } // GuildWebhooks returns the webhooks of the guild with the given ID. // // Requires the MANAGE_WEBHOOKS permission. func (c *Client) GuildWebhooks(guildID discord.Snowflake) ([]discord.Webhook, error) { var ws []discord.Webhook return ws, c.RequestJSON(&ws, "GET", EndpointGuilds+guildID.String()+"/webhooks") } // Webhook returns the webhook with the given id. func (c *Client) Webhook(webhookID discord.Snowflake) (*discord.Webhook, error) { var w *discord.Webhook return w, c.RequestJSON(&w, "GET", EndpointWebhooks+webhookID.String()) } // WebhookWithToken is the same as above, except this call does not require // authentication and returns no user in the webhook object. func (c *Client) WebhookWithToken( webhookID discord.Snowflake, token string) (*discord.Webhook, error) { var w *discord.Webhook return w, c.RequestJSON(&w, "GET", EndpointWebhooks+webhookID.String()+"/"+token) } // https://discord.com/developers/docs/resources/webhook#modify-webhook-json-params type ModifyWebhookData struct { // Name is the default name of the webhook. Name option.String `json:"name,omitempty"` // Avatar is the image for the default webhook avatar. Avatar *Image `json:"avatar,omitempty"` // ChannelID is the new channel id this webhook should be moved to. ChannelID discord.Snowflake `json:"channel_id,omitempty"` } // ModifyWebhook modifies a webhook. // // Requires the MANAGE_WEBHOOKS permission. func (c *Client) ModifyWebhook( webhookID discord.Snowflake, data ModifyWebhookData) (*discord.Webhook, error) { var w *discord.Webhook return w, c.RequestJSON( &w, "PATCH", EndpointWebhooks+webhookID.String(), httputil.WithJSONBody(data), ) } // ModifyWebhookWithToken is the same as above, except this call does not // require authentication, does not accept a channel_id parameter in the body, // and does not return a user in the webhook object. func (c *Client) ModifyWebhookWithToken( webhookID discord.Snowflake, data ModifyWebhookData, token string) (*discord.Webhook, error) { var w *discord.Webhook return w, c.RequestJSON( &w, "PATCH", EndpointWebhooks+webhookID.String()+"/"+token, httputil.WithJSONBody(data), ) } // DeleteWebhook deletes a webhook permanently. // // Requires the MANAGE_WEBHOOKS permission. func (c *Client) DeleteWebhook(webhookID discord.Snowflake) error { return c.FastRequest("DELETE", EndpointWebhooks+webhookID.String()) } // DeleteWebhookWithToken is the same as above, except this call does not // require authentication. func (c *Client) DeleteWebhookWithToken(webhookID discord.Snowflake, token string) error { return c.FastRequest("DELETE", EndpointWebhooks+webhookID.String()+"/"+token) }