Module: Discordrb::API
- Defined in:
- lib/discordrb/api.rb
Overview
List of methods representing endpoints in Discord’s API
Constant Summary collapse
- APIBASE =
'https://discordapp.com/api'
Class Method Summary collapse
-
.acknowledge_message(token, channel_id, message_id) ⇒ Object
Acknowledge that a message has been received The last acknowledged message will be sent in the ready packet, so this is an easy way to catch up on messages.
-
.ban_user(token, server_id, user_id, message_days) ⇒ Object
Ban a user from a server and delete their messages from the last message_days days.
-
.bans(token, server_id) ⇒ Object
Get a server’s banned users.
-
.channel(token, channel_id) ⇒ Object
Get a channel’s data.
-
.channel_log(token, channel_id, amount, before = nil, after = nil) ⇒ Object
Get a list of messages from a channel’s history.
-
.create_channel(token, server_id, name, type) ⇒ Object
Create a channel.
-
.create_invite(token, id, max_age = 0, max_uses = 0, temporary = false, xkcd = false) ⇒ Object
Create an instant invite from a server or a channel id.
-
.create_private(token, bot_user_id, user_id) ⇒ Object
Create a private channel.
-
.create_role(token, server_id) ⇒ Object
Create a role (parameters such as name and colour will have to be set by update_role afterwards).
-
.create_server(token, name, region) ⇒ Object
Create a server.
-
.delete_channel(token, channel_id) ⇒ Object
Delete a channel.
-
.delete_message(token, channel_id, message_id) ⇒ Object
Delete a message.
-
.delete_role(token, server_id, role_id) ⇒ Object
Delete a role.
-
.edit_message(token, channel_id, message_id, message, mentions = []) ⇒ Object
Edit a message.
-
.gateway(token) ⇒ Object
Get the gateway to be used.
-
.join_server(token, invite_id) ⇒ Object
Join a server using an invite.
-
.leave_server(server_id) ⇒ Object
Leave a server.
-
.login(email, password) ⇒ Object
Login to the server.
-
.logout(token) ⇒ Object
Logout from the server.
-
.resolve_invite(token, code) ⇒ Object
Resolve an invite.
-
.send_file(token, channel_id, file) ⇒ Object
Send a file as a message to a channel.
-
.send_message(token, channel_id, message, mentions = [], tts = false) ⇒ Object
Send a message to a channel.
-
.start_typing(token, channel_id) ⇒ Object
Start typing (needs to be resent every 5 seconds to keep up the typing).
-
.update_channel(token, channel_id, name, topic, position = 0) ⇒ Object
Update a channel’s data.
-
.update_role(token, server_id, role_id, name, colour, hoist = false, packed_permissions = 36_953_089) ⇒ Object
Update a role Permissions are the Discord defaults; allowed: invite creation, reading/sending messages, sending TTS messages, embedding links, sending files, reading the history, mentioning everybody, connecting to voice, speaking and voice activity (push-to-talk isn’t mandatory).
-
.update_role_overrides(token, channel_id, role_id, allow, deny) ⇒ Object
Update a role’s permission overrides in a channel.
-
.update_user(token, email, password, new_username, avatar, new_password = nil) ⇒ Object
Update user data.
-
.update_user_overrides(token, channel_id, user_id, allow, deny) ⇒ Object
Update a user’s permission overrides in a channel.
-
.update_user_roles(token, server_id, user_id, roles) ⇒ Object
Update a user’s roles.
-
.user(token, user_id) ⇒ Object
Get user data.
Class Method Details
.acknowledge_message(token, channel_id, message_id) ⇒ Object
Acknowledge that a message has been received The last acknowledged message will be sent in the ready packet, so this is an easy way to catch up on messages
164 165 166 167 168 169 |
# File 'lib/discordrb/api.rb', line 164 def (token, channel_id, ) RestClient.post( "#{APIBASE}/channels/#{channel_id}/messages/#{}/ack", Authorization: token ) end |
.ban_user(token, server_id, user_id, message_days) ⇒ Object
Ban a user from a server and delete their messages from the last message_days days
11 12 13 14 15 16 |
# File 'lib/discordrb/api.rb', line 11 def ban_user(token, server_id, user_id, ) RestClient.put( "#{APIBASE}/guilds/#{server_id}/bans/#{user_id}?delete-message-days=#{}", Authorization: token ) end |
.bans(token, server_id) ⇒ Object
Get a server’s banned users
19 20 21 22 23 24 |
# File 'lib/discordrb/api.rb', line 19 def bans(token, server_id) RestClient.get( "#{APIBASE}/guilds/#{server_id}/bans", Authorization: token ) end |
.channel(token, channel_id) ⇒ Object
Get a channel’s data
62 63 64 65 66 67 |
# File 'lib/discordrb/api.rb', line 62 def channel(token, channel_id) RestClient.get( "#{APIBASE}/channels/#{channel_id}", Authorization: token ) end |
.channel_log(token, channel_id, amount, before = nil, after = nil) ⇒ Object
Get a list of messages from a channel’s history
274 275 276 277 278 279 |
# File 'lib/discordrb/api.rb', line 274 def channel_log(token, channel_id, amount, before = nil, after = nil) RestClient.get( "#{APIBASE}/channels/#{channel_id}/messages?limit=#{amount}#{"&before=#{before}" if before}#{"&after=#{after}" if after}", Authorization: token ) end |
.create_channel(token, server_id, name, type) ⇒ Object
Create a channel
70 71 72 73 74 75 76 77 |
# File 'lib/discordrb/api.rb', line 70 def create_channel(token, server_id, name, type) RestClient.post( "#{APIBASE}/guilds/#{server_id}/channels", { 'name' => name, 'type' => type }.to_json, Authorization: token, content_type: :json ) end |
.create_invite(token, id, max_age = 0, max_uses = 0, temporary = false, xkcd = false) ⇒ Object
Create an instant invite from a server or a channel id
124 125 126 127 128 129 130 131 |
# File 'lib/discordrb/api.rb', line 124 def create_invite(token, id, max_age = 0, max_uses = 0, temporary = false, xkcd = false) RestClient.post( "#{APIBASE}/channels/#{id}/invites", { 'max_age' => max_age, 'max_uses' => max_uses, 'temporary' => temporary, 'xkcdpass' => xkcd }.to_json, Authorization: token, content_type: :json ) end |
.create_private(token, bot_user_id, user_id) ⇒ Object
Create a private channel
114 115 116 117 118 119 120 121 |
# File 'lib/discordrb/api.rb', line 114 def create_private(token, bot_user_id, user_id) RestClient.post( "#{APIBASE}/users/#{bot_user_id}/channels", { 'recipient_id' => user_id }.to_json, Authorization: token, content_type: :json ) end |
.create_role(token, server_id) ⇒ Object
Create a role (parameters such as name and colour will have to be set by update_role afterwards)
181 182 183 184 185 186 |
# File 'lib/discordrb/api.rb', line 181 def create_role(token, server_id) RestClient.post( "#{APIBASE}/guilds/#{server_id}/roles", Authorization: token ) end |
.create_server(token, name, region) ⇒ Object
Create a server
44 45 46 47 48 49 50 51 |
# File 'lib/discordrb/api.rb', line 44 def create_server(token, name, region) RestClient.post( "#{APIBASE}/guilds", { 'name' => name, 'region' => region }.to_json, Authorization: token, content_type: :json ) end |
.delete_channel(token, channel_id) ⇒ Object
Delete a channel
90 91 92 93 94 95 |
# File 'lib/discordrb/api.rb', line 90 def delete_channel(token, channel_id) RestClient.delete( "#{APIBASE}/channels/#{channel_id}", Authorization: token ) end |
.delete_message(token, channel_id, message_id) ⇒ Object
Delete a message
144 145 146 147 148 149 |
# File 'lib/discordrb/api.rb', line 144 def (token, channel_id, ) RestClient.delete( "#{APIBASE}/channels/#{channel_id}/messages/#{}", Authorization: token ) end |
.delete_role(token, server_id, role_id) ⇒ Object
Delete a role
202 203 204 205 206 207 |
# File 'lib/discordrb/api.rb', line 202 def delete_role(token, server_id, role_id) RestClient.delete( "#{APIBASE}/guilds/#{server_id}/roles/#{role_id}", Authorization: token ) end |
.edit_message(token, channel_id, message_id, message, mentions = []) ⇒ Object
Edit a message
152 153 154 155 156 157 158 159 |
# File 'lib/discordrb/api.rb', line 152 def (token, channel_id, , , mentions = []) RestClient.patch( "#{APIBASE}/channels/#{channel_id}/messages/#{}", { 'content' => , 'mentions' => mentions }.to_json, Authorization: token, content_type: :json ) end |
.gateway(token) ⇒ Object
Get the gateway to be used
240 241 242 243 244 245 |
# File 'lib/discordrb/api.rb', line 240 def gateway(token) RestClient.get( "#{APIBASE}/gateway", Authorization: token ) end |
.join_server(token, invite_id) ⇒ Object
Join a server using an invite
98 99 100 101 102 103 |
# File 'lib/discordrb/api.rb', line 98 def join_server(token, invite_id) RestClient.post( "#{APIBASE}/invite/#{invite_id}", Authorization: token ) end |
.leave_server(server_id) ⇒ Object
Leave a server
54 55 56 57 58 59 |
# File 'lib/discordrb/api.rb', line 54 def leave_server(server_id) RestClient.delete( "#{APIBASE}/guilds/#{server_id}", Authorization: token ) end |
.login(email, password) ⇒ Object
Login to the server
27 28 29 30 31 32 33 |
# File 'lib/discordrb/api.rb', line 27 def login(email, password) RestClient.post( "#{APIBASE}/auth/login", email: email, password: password ) end |
.logout(token) ⇒ Object
Logout from the server
36 37 38 39 40 41 |
# File 'lib/discordrb/api.rb', line 36 def logout(token) RestClient.post( "#{APIBASE}/auth/logout", Authorization: token ) end |
.resolve_invite(token, code) ⇒ Object
Resolve an invite
106 107 108 109 110 111 |
# File 'lib/discordrb/api.rb', line 106 def resolve_invite(token, code) RestClient.get( "#{APIBASE}/invite/#{code}", Authorization: token ) end |
.send_file(token, channel_id, file) ⇒ Object
Send a file as a message to a channel
172 173 174 175 176 177 178 |
# File 'lib/discordrb/api.rb', line 172 def send_file(token, channel_id, file) RestClient.post( "#{APIBASE}/channels/#{channel_id}/messages", { file: file }, Authorization: token ) end |
.send_message(token, channel_id, message, mentions = [], tts = false) ⇒ Object
Send a message to a channel
134 135 136 137 138 139 140 141 |
# File 'lib/discordrb/api.rb', line 134 def (token, channel_id, , mentions = [], tts = false) RestClient.post( "#{APIBASE}/channels/#{channel_id}/messages", { 'content' => , 'mentions' => mentions, tts => tts }.to_json, Authorization: token, content_type: :json ) end |
.start_typing(token, channel_id) ⇒ Object
Start typing (needs to be resent every 5 seconds to keep up the typing)
248 249 250 251 252 253 |
# File 'lib/discordrb/api.rb', line 248 def start_typing(token, channel_id) RestClient.post( "#{APIBASE}/channels/#{channel_id}/typing", Authorization: token ) end |
.update_channel(token, channel_id, name, topic, position = 0) ⇒ Object
Update a channel’s data
80 81 82 83 84 85 86 87 |
# File 'lib/discordrb/api.rb', line 80 def update_channel(token, channel_id, name, topic, position = 0) RestClient.patch( "#{APIBASE}/channels/#{channel_id}", { 'name' => name, 'position' => position, 'topic' => topic }.to_json, Authorization: token, content_type: :json ) end |
.update_role(token, server_id, role_id, name, colour, hoist = false, packed_permissions = 36_953_089) ⇒ Object
Update a role Permissions are the Discord defaults; allowed: invite creation, reading/sending messages, sending TTS messages, embedding links, sending files, reading the history, mentioning everybody, connecting to voice, speaking and voice activity (push-to-talk isn’t mandatory)
192 193 194 195 196 197 198 199 |
# File 'lib/discordrb/api.rb', line 192 def update_role(token, server_id, role_id, name, colour, hoist = false, = 36_953_089) RestClient.patch( "#{APIBASE}/guilds/#{server_id}/roles/#{role_id}", { 'color' => colour, 'name' => name, 'hoist' => hoist, 'permissions' => }.to_json, Authorization: token, content_type: :json ) end |
.update_role_overrides(token, channel_id, role_id, allow, deny) ⇒ Object
Update a role’s permission overrides in a channel
230 231 232 233 234 235 236 237 |
# File 'lib/discordrb/api.rb', line 230 def update_role_overrides(token, channel_id, role_id, allow, deny) RestClient.put( "#{APIBASE}/channels/#{channel_id}/permissions/#{role_id}", { 'type' => 'role', 'id' => role_id, 'allow' => allow, 'deny' => deny }.to_json, Authorization: token, content_type: :json ) end |
.update_user(token, email, password, new_username, avatar, new_password = nil) ⇒ Object
Update user data
264 265 266 267 268 269 270 271 |
# File 'lib/discordrb/api.rb', line 264 def update_user(token, email, password, new_username, avatar, new_password = nil) RestClient.patch( "#{APIBASE}/users/@me", { 'avatar' => avatar, 'email' => email, 'new_password' => new_password, 'password' => password, 'username' => new_username }.to_json, Authorization: token, content_type: :json ) end |
.update_user_overrides(token, channel_id, user_id, allow, deny) ⇒ Object
Update a user’s permission overrides in a channel
220 221 222 223 224 225 226 227 |
# File 'lib/discordrb/api.rb', line 220 def update_user_overrides(token, channel_id, user_id, allow, deny) RestClient.put( "#{APIBASE}/channels/#{channel_id}/permissions/#{user_id}", { 'type' => 'member', 'id' => user_id, 'allow' => allow, 'deny' => deny }.to_json, Authorization: token, content_type: :json ) end |
.update_user_roles(token, server_id, user_id, roles) ⇒ Object
Update a user’s roles
210 211 212 213 214 215 216 217 |
# File 'lib/discordrb/api.rb', line 210 def update_user_roles(token, server_id, user_id, roles) RestClient.patch( "#{APIBASE}/guilds/#{server_id}/members/#{user_id}", { 'roles' => roles }.to_json, Authorization: token, content_type: :json ) end |
.user(token, user_id) ⇒ Object
Get user data
256 257 258 259 260 261 |
# File 'lib/discordrb/api.rb', line 256 def user(token, user_id) RestClient.get( "#{APIBASE}/users/#{user_id}", Authorization: token ) end |