mirror of
https://github.com/diamondburned/arikawa.git
synced 2024-08-19 23:04:51 +00:00
* v3: discord, api, gateway: add per-guild avatars * api: rename ModifyMe to ModifyCurrentUser
140 lines
4.1 KiB
Go
140 lines
4.1 KiB
Go
package api
|
|
|
|
import (
|
|
"github.com/diamondburned/arikawa/v3/discord"
|
|
"github.com/diamondburned/arikawa/v3/utils/httputil"
|
|
"github.com/diamondburned/arikawa/v3/utils/json/option"
|
|
)
|
|
|
|
var (
|
|
EndpointUsers = Endpoint + "users/"
|
|
EndpointMe = EndpointUsers + "@me"
|
|
)
|
|
|
|
// User returns a user object for a given user ID.
|
|
func (c *Client) User(userID discord.UserID) (*discord.User, error) {
|
|
var u *discord.User
|
|
return u, c.RequestJSON(&u, "GET", EndpointUsers+userID.String())
|
|
}
|
|
|
|
// Me returns the user object of the requester's account. For OAuth2, this
|
|
// requires the identify scope, which will return the object without an email,
|
|
// and optionally the email scope, which returns the object with an email.
|
|
func (c *Client) Me() (*discord.User, error) {
|
|
var me *discord.User
|
|
return me, c.RequestJSON(&me, "GET", EndpointMe)
|
|
}
|
|
|
|
// https://discord.com/developers/docs/resources/user#modify-current-user-json-params
|
|
type ModifyCurrentUserData struct {
|
|
// Username is the user's username, if changed may cause the user's
|
|
// discriminator to be randomized.
|
|
Username option.String `json:"username,omitempty"`
|
|
// Avatar modifies the user's avatar.
|
|
Avatar *Image `json:"image,omitempty"`
|
|
|
|
AuditLogReason `json:"-"`
|
|
}
|
|
|
|
// ModifyCurrentUser modifies the requester's user account settings.
|
|
func (c *Client) ModifyCurrentUser(data ModifyCurrentUserData) (*discord.User, error) {
|
|
var u *discord.User
|
|
return u, c.RequestJSON(
|
|
&u,
|
|
"PATCH", EndpointMe,
|
|
httputil.WithJSONBody(data), httputil.WithHeaders(data.Header()),
|
|
)
|
|
}
|
|
|
|
// ModifyCurrentMember modifies the nickname of the current user in a guild.
|
|
//
|
|
// Fires a Guild Member Update Gateway event.
|
|
func (c *Client) ModifyCurrentMember(
|
|
guildID discord.GuildID, nick string) error {
|
|
|
|
var param struct {
|
|
Nick string `json:"nick"`
|
|
}
|
|
|
|
param.Nick = nick
|
|
|
|
return c.FastRequest(
|
|
"PATCH",
|
|
EndpointGuilds+guildID.String()+"/members/@me",
|
|
httputil.WithJSONBody(param),
|
|
)
|
|
}
|
|
|
|
// PrivateChannels returns a list of DM channel objects. For bots, this is no
|
|
// longer a supported method of getting recent DMs, and will return an empty
|
|
// array.
|
|
func (c *Client) PrivateChannels() ([]discord.Channel, error) {
|
|
var dms []discord.Channel
|
|
return dms, c.RequestJSON(&dms, "GET", EndpointMe+"/channels")
|
|
}
|
|
|
|
// CreatePrivateChannel creates a new DM channel with a user.
|
|
func (c *Client) CreatePrivateChannel(recipientID discord.UserID) (*discord.Channel, error) {
|
|
var param struct {
|
|
RecipientID discord.UserID `json:"recipient_id"`
|
|
}
|
|
|
|
param.RecipientID = recipientID
|
|
|
|
var dm *discord.Channel
|
|
return dm, c.RequestJSON(&dm, "POST", EndpointMe+"/channels", httputil.WithJSONBody(param))
|
|
}
|
|
|
|
// UserConnections returns a list of connection objects. Requires the
|
|
// connections OAuth2 scope.
|
|
func (c *Client) UserConnections() ([]discord.Connection, error) {
|
|
var conn []discord.Connection
|
|
return conn, c.RequestJSON(&conn, "GET", EndpointMe+"/connections")
|
|
}
|
|
|
|
// Note gets the note for the given user. This endpoint is undocumented and
|
|
// might only work for user accounts.
|
|
func (c *Client) Note(userID discord.UserID) (string, error) {
|
|
var body struct {
|
|
Note string `json:"note"`
|
|
}
|
|
|
|
return body.Note, c.RequestJSON(&body, "GET", EndpointMe+"/notes/"+userID.String())
|
|
}
|
|
|
|
// SetNote sets a note for the user. This endpoint is undocumented and might
|
|
// only work for user accounts.
|
|
func (c *Client) SetNote(userID discord.UserID, note string) error {
|
|
var body = struct {
|
|
Note string `json:"note"`
|
|
}{
|
|
Note: note,
|
|
}
|
|
|
|
return c.FastRequest(
|
|
"PUT", EndpointMe+"/notes/"+userID.String(),
|
|
httputil.WithJSONBody(body),
|
|
)
|
|
}
|
|
|
|
// SetRelationship sets the relationship type between the current user and the
|
|
// given user.
|
|
func (c *Client) SetRelationship(userID discord.UserID, t discord.RelationshipType) error {
|
|
var body = struct {
|
|
Type discord.RelationshipType `json:"type"`
|
|
}{
|
|
Type: t,
|
|
}
|
|
|
|
return c.FastRequest(
|
|
"PUT", EndpointMe+"/relationships/"+userID.String(),
|
|
httputil.WithJSONBody(body),
|
|
)
|
|
}
|
|
|
|
// DeleteRelationship deletes the relationship between the current user and the
|
|
// given user.
|
|
func (c *Client) DeleteRelationship(userID discord.UserID) error {
|
|
return c.FastRequest("DELETE", EndpointMe+"/relationships/"+userID.String())
|
|
}
|