some infra

2026-08-27 21:47:03 +02:00
parent 7c2a2aecd1
commit 73809eaa7c
61 changed files with 253 additions and 17 deletions
@@ -0,0 +1,51 @@
+/**
+ * @file invite.h
+ * @author Cogmasters
+ * @brief Invite public functions and datatypes
+ */
+
+#ifndef DISCORD_INVITE_H
+#define DISCORD_INVITE_H
+
+/** @defgroup DiscordAPIInvite Invite
+ * @ingroup DiscordAPI
+ * @brief Invite's public API supported by Concord
+ *  @{ */
+
+/**
+ * @brief Get an invite for the given code
+ *
+ * @param client the client created with discord_from_token()
+ * @param invite_code the invite code
+ * @param params request parameters
+ * @CCORD_ret_obj{ret,invite}
+ * @CCORD_return
+ */
+CCORDcode discord_get_invite(struct discord *client,
+                             char *invite_code,
+                             struct discord_get_invite *params,
+                             struct discord_ret_invite *ret);
+
+/**
+ * @brief Delete an invite
+ * @note Requires the MANAGE_CHANNELS permission on the channel this invite
+ *        belongs to, or MANAGE_GUILD to remove any invite across the guild.
+ * @note Fires a `Invite Delete` event
+ *
+ * @param client the client created with discord_from_token()
+ * @param invite_code the invite code
+ * @param params request parameters
+ * @CCORD_ret_obj{ret,invite}
+ * @CCORD_return
+ */
+CCORDcode discord_delete_invite(struct discord *client,
+                                char *invite_code,
+                                struct discord_delete_invite *params,
+                                struct discord_ret_invite *ret);
+
+/** @example invite.c
+ * Demonstrates a couple use cases of the Invite API */
+
+/** @} DiscordAPIInvite */
+
+#endif /* DISCORD_INVITE_H */