discord.http — org.clojars.kerethril/discord.clj 2.0.0

Functions and Records used to interact directly with the Discord API. Any actions performed on Discord eventually boil down to some form of API request. The API endpoints are represented as human-readable keywords and implemented using the discord-request helper function. Exposed externally are functions such as get-channel, which perform the API requests and handle the transformation of the response into a more usable Clojure record.

add-reaction clj

(add-reaction auth channel message emoji)

ban clj

(ban auth guild user)

build-channel clj

(build-channel channel-map)

build-server clj

(build-server server-map)

build-user clj

(build-user user-map)

channel-type-map clj

clear-reactions clj

(clear-reactions auth channel message)

create-channel clj

(create-channel auth guild channel-name & {:keys [type bitrate] :as params})

create-dm-channel clj

(create-dm-channel auth user)

create-server clj

(create-server auth server-name icon region)

delete-channel clj

(delete-channel auth channel)

delete-message clj

(delete-message auth channel message)

delete-messages clj

(delete-messages auth channel messages)

delete-server clj

(delete-server auth guild)

discord-request clj

(discord-request
  endpoint-key
  auth
  &
  {:keys [json params args constructor] :or {constructor identity} :as opts})

General wrapper function for sending a request to one of the pre-defined Discord API endpoints. This function calls other helper functions to handle the following:

• Retrieving the API endpoint to call
• Formatting the request
• Sending the API call
• Deferred retries of API calls in the event of a 429 Rate Limit response

Arguments: endpoint-key: A keyword that maps to a defined endpoint in endpoint-mapping auth: Something that implements the Authenticated protocol to auth with the Discord APIs

Options are passed :key val ... Supported options:

:json map - An optional JSON body to pass along with post/put/patch/delete request :params map - Optional query parameters to pass along with a get request :args list - In order (format) arguments to correctly format the endpoint from endpoint-mapping :constructor f - A function which is mapped over API responses to create appropriate Records.

discord-url clj

edit-channel clj

(edit-channel auth channel & {:keys [name topic bitrate position] :as params})

edit-member clj

(edit-member auth
             guild
             user
             &
             {:keys [nick roles mute deaf channel_id] :as params})

edit-message clj

(edit-message auth channel message content & {:keys [embed]})

edit-profile clj

(edit-profile auth & {:keys [username avatar] :as params})

endpoint-mapping clj

estimate-prune-members clj

(estimate-prune-members auth guild days)

find-channel clj

(find-channel auth guild channel-name)

find-member clj

(find-member auth guild member-name)

find-server clj

(find-server auth server-name)

get-bot-gateway clj

(get-bot-gateway auth)

get-channel clj

(get-channel auth channel)

get-current-user clj

(get-current-user auth)

get-endpoint clj

(get-endpoint endpoint-key endpoint-args)

get-gateway clj

(get-gateway auth)

get-guild clj

(get-guild auth guild)

get-guild-channels clj

(get-guild-channels auth guild)

get-guild-member clj

(get-guild-member auth guild user)

get-member clj

(get-member auth guild user)

get-message clj

(get-message auth channel message)

get-roles clj

(get-roles auth guild)

get-servers clj

(get-servers auth)

get-text-channels clj

(get-text-channels auth guild)

get-voice-channels clj

(get-voice-channels auth guild)

kick clj

(kick auth guild user)

list-members clj

(list-members auth guild & {:keys [limit after] :as params})

logs-from clj

(logs-from auth channel limit & {:keys [before after around] :as params})

modify-server clj

(modify-server auth guild & {:keys [name region] :as params})

move-channel clj

(move-channel auth channel new-position)

pin-message clj

(pin-message auth channel message)

pins-from clj

(pins-from auth channel)

prune-members clj

(prune-members auth guild days)

rate-limit-pool clj

reaction-users clj

(reaction-users auth channel message emoji & {:keys [limit after] :as params})

remove-reaction clj

(remove-reaction auth channel message emoji user)

send-message clj

(send-message auth channel content & {:keys [tts embed]})

send-typing clj

(send-typing auth channel)

unban clj

(unban auth guild user)

unpin-message clj

(unpin-message auth channel message)

update-nickname clj

(update-nickname auth guild nickname)

user-agent clj