Package net.dv8tion.jda.core.entities

Interface Invite

public interface Invite

Representation of a Discord Invite. This class is immutable.

Since:

3.0

Author:

Aljoscha Grebe

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	Invite.Channel	POJO for the channel information provided by an invite.
static interface	Invite.Group	POJO for the group information provided by an invite.
static interface	Invite.Guild	POJO for the guild information provided by an invite.
static class	Invite.InviteType	Enum representing the type of an invite.

Method Summary

Modifier and Type	Method	Description
AuditableRestAction<java.lang.Void>	delete()	Deletes this invite.
RestAction<Invite>	expand()	Tries to retrieve a new expanded Invite with more info.
Invite.Channel	getChannel()	An Invite.Channel object containing information about this invite's origin channel.
java.lang.String	getCode()	The invite code
java.time.OffsetDateTime	getCreationTime()	Returns creation date of this invite.
Invite.Group	getGroup()	An Invite.Group object containing information about this invite's origin group.
Invite.Guild	getGuild()	An Invite.Guild object containing information about this invite's origin guild.
User	getInviter()	The user who created this invite.
JDA	getJDA()	The JDA instance used to create this Invite
int	getMaxAge()	The max age of this invite in seconds.
int	getMaxUses()	The max uses of this invite.
Invite.InviteType	getType()	The type of this invite.
default java.lang.String	getURL()	The invite URL for this invite in the format of: "https://discord.gg/" + getCode()
int	getUses()	How often this invite has been used.
boolean	isExpanded()	Whether this Invite is expanded or not.
boolean	isTemporary()	Whether this Invite grants only temporary access or not
static RestAction<Invite>	resolve(JDA api, java.lang.String code)	Retrieves a new Invite instance for the given invite code.
static RestAction<Invite>	resolve(JDA api, java.lang.String code, boolean withCounts)	Retrieves a new Invite instance for the given invite code.

Method Detail

resolve

static RestAction<Invite> resolve(JDA api,
                                  java.lang.String code)

Retrieves a new Invite instance for the given invite code.
You cannot resolve invites if you were banned from the origin Guild!

Possible ErrorResponses include:

• Unknown Invite
  The Invite did not exist (possibly deleted) or the account is banned in the guild.

Parameters:

api - The JDA instance

code - A valid invite code

Returns:

RestAction - Type: Invite
The Invite object

resolve

static RestAction<Invite> resolve(JDA api,
                                  java.lang.String code,
                                  boolean withCounts)

Retrieves a new Invite instance for the given invite code.
You cannot resolve invites if you were banned from the origin Guild!

Possible ErrorResponses include:

• Unknown Invite
  The Invite did not exist (possibly deleted) or the account is banned in the guild.

Parameters:

api - The JDA instance

code - A valid invite code

withCounts - Whether or not to include online and member counts for guild invites or users for group invites

Returns:

RestAction - Type: Invite
The Invite object

delete

@CheckReturnValue
AuditableRestAction<java.lang.Void> delete()

Deletes this invite.
Requires MANAGE_CHANNEL in the invite's channel. Will throw a InsufficientPermissionException otherwise.

Returns:

AuditableRestAction

Throws:

InsufficientPermissionException - if the account does not have MANAGE_SERVER in the invite's channel

expand

@CheckReturnValue
RestAction<Invite> expand()

Tries to retrieve a new expanded Invite with more info.
As bots can't be in groups this is only available for guild invites and will throw an IllegalStateException for other types.
Requires either MANAGE_SERVER in the invite's guild or MANAGE_CHANNEL in the invite's channel. Will throw a InsufficientPermissionException otherwise.

Returns:

RestAction - Type: Invite
The expanded Invite object

Throws:

InsufficientPermissionException - if the account neither has MANAGE_SERVER in the invite's guild nor MANAGE_CHANNEL in the invite's channel

java.lang.IllegalStateException - If this is a group invite

See Also:

getType(), isExpanded()

getType

Invite.InviteType getType()

The type of this invite.

Returns:

The invites's type

getChannel

Invite.Channel getChannel()

An Invite.Channel object containing information about this invite's origin channel.

Returns:

Information about this invite's origin channel or null in case of a group invite

See Also:

Invite.Channel

getCode

java.lang.String getCode()

The invite code

Returns:

the invite code

getGroup

Invite.Group getGroup()

An Invite.Group object containing information about this invite's origin group.

Returns:

Information about this invite's origin group or null in case of a guild invite

See Also:

Invite.Group

getURL

default java.lang.String getURL()

The invite URL for this invite in the format of: "https://discord.gg/" + getCode()

Returns:

Invite URL for this Invite

getCreationTime

java.time.OffsetDateTime getCreationTime()

Returns creation date of this invite.

This works only for expanded invites and will throw a IllegalStateException otherwise!

Returns:

The creation date of this invite

Throws:

java.lang.IllegalStateException - if this invite is not expanded

See Also:

expand(), isExpanded()

getGuild

Invite.Guild getGuild()

An Invite.Guild object containing information about this invite's origin guild.

Returns:

Information about this invite's origin guild or null in case of a group invite

See Also:

Invite.Guild

getInviter

User getInviter()

The user who created this invite. This may be a fake user. For not expanded invites this may be null.

Returns:

The user who created this invite

getJDA

JDA getJDA()

The JDA instance used to create this Invite

Returns:

the corresponding JDA instance

getMaxAge

int getMaxAge()

The max age of this invite in seconds.

This works only for expanded invites and will throw a IllegalStateException otherwise!

Returns:

The max age of this invite in seconds

Throws:

java.lang.IllegalStateException - if this invite is not expanded

See Also:

expand(), isExpanded()

getMaxUses

int getMaxUses()

The max uses of this invite. If there is no limit thus will return 0.

This works only for expanded invites and will throw a IllegalStateException otherwise!

Returns:

The max uses of this invite or 0 if there is no limit

Throws:

java.lang.IllegalStateException - if this invite is not expanded

See Also:

expand(), isExpanded()

getUses

int getUses()

How often this invite has been used.

This works only for expanded invites and will throw a IllegalStateException otherwise!

Returns:

The uses of this invite

Throws:

java.lang.IllegalStateException - if this invite is not expanded

See Also:

expand(), isExpanded()

isExpanded

boolean isExpanded()

Whether this Invite is expanded or not. Expanded invites contain more information, but they can only be obtained be Guild#getInvites() (requires Permission.MANAGE_CHANNEL) or Channel#getInvites() (requires Permission.MANAGE_SERVER).

There is a convenience method expand() to get the expanded invite for an unexpanded one.

Returns:

Whether is invite expanded or not

See Also:

expand()

isTemporary

boolean isTemporary()

Whether this Invite grants only temporary access or not

Returns:

Whether is invite expanded or not

Throws:

java.lang.IllegalStateException - if this invite is not expanded