Concord - C Discord API library
A Discord API wrapper library written in C
channel.h
Go to the documentation of this file.
1
7#ifndef DISCORD_CHANNEL_H
8#define DISCORD_CHANNEL_H
9
10/* forward declaration */
11struct discord_ret_users;
12
13
29CCORDcode discord_get_channel(struct discord *client,
30 u64snowflake channel_id,
31 struct discord_ret_channel *ret);
32
42CCORDcode discord_modify_channel(struct discord *client,
43 u64snowflake channel_id,
44 struct discord_modify_channel *params,
45 struct discord_ret_channel *ret);
46
63CCORDcode discord_delete_channel(struct discord *client,
64 u64snowflake channel_id,
65 struct discord_delete_channel *params,
66 struct discord_ret_channel *ret);
67
84CCORDcode discord_get_channel_messages(
85 struct discord *client,
86 u64snowflake channel_id,
87 struct discord_get_channel_messages *params,
88 struct discord_ret_messages *ret);
89
100CCORDcode discord_get_channel_message(struct discord *client,
101 u64snowflake channel_id,
102 u64snowflake message_id,
103 struct discord_ret_message *ret);
104
115CCORDcode discord_create_message(struct discord *client,
116 u64snowflake channel_id,
117 struct discord_create_message *params,
118 struct discord_ret_message *ret);
119
133CCORDcode discord_crosspost_message(struct discord *client,
134 u64snowflake channel_id,
135 u64snowflake message_id,
136 struct discord_ret_message *ret);
137
149CCORDcode discord_create_reaction(struct discord *client,
150 u64snowflake channel_id,
151 u64snowflake message_id,
152 u64snowflake emoji_id,
153 const char emoji_name[],
154 struct discord_ret *ret);
155
167CCORDcode discord_delete_own_reaction(struct discord *client,
168 u64snowflake channel_id,
169 u64snowflake message_id,
170 u64snowflake emoji_id,
171 const char emoji_name[],
172 struct discord_ret *ret);
173
186CCORDcode discord_delete_user_reaction(struct discord *client,
187 u64snowflake channel_id,
188 u64snowflake message_id,
189 u64snowflake user_id,
190 u64snowflake emoji_id,
191 const char emoji_name[],
192 struct discord_ret *ret);
193
206CCORDcode discord_get_reactions(struct discord *client,
207 u64snowflake channel_id,
208 u64snowflake message_id,
209 u64snowflake emoji_id,
210 const char emoji_name[],
211 struct discord_get_reactions *params,
212 struct discord_ret_users *ret);
213
223CCORDcode discord_delete_all_reactions(struct discord *client,
224 u64snowflake channel_id,
225 u64snowflake message_id,
226 struct discord_ret *ret);
227
240CCORDcode discord_delete_all_reactions_for_emoji(struct discord *client,
241 u64snowflake channel_id,
242 u64snowflake message_id,
243 u64snowflake emoji_id,
244 const char emoji_name[],
245 struct discord_ret *ret);
246
258CCORDcode discord_edit_message(struct discord *client,
259 u64snowflake channel_id,
260 u64snowflake message_id,
261 struct discord_edit_message *params,
262 struct discord_ret_message *ret);
263
274CCORDcode discord_delete_message(struct discord *client,
275 u64snowflake channel_id,
276 u64snowflake message_id,
277 struct discord_delete_message *params,
278 struct discord_ret *ret);
279
289CCORDcode discord_bulk_delete_messages(
290 struct discord *client,
291 u64snowflake channel_id,
292 struct discord_bulk_delete_messages *params,
293 struct discord_ret *ret);
294
306CCORDcode discord_edit_channel_permissions(
307 struct discord *client,
308 u64snowflake channel_id,
309 u64snowflake overwrite_id,
310 struct discord_edit_channel_permissions *params,
311 struct discord_ret *ret);
312
321CCORDcode discord_get_channel_invites(struct discord *client,
322 u64snowflake channel_id,
323 struct discord_ret_invites *ret);
324
334CCORDcode discord_create_channel_invite(
335 struct discord *client,
336 u64snowflake channel_id,
337 struct discord_create_channel_invite *params,
338 struct discord_ret_invite *ret);
339
351CCORDcode discord_delete_channel_permission(
352 struct discord *client,
353 u64snowflake channel_id,
354 u64snowflake overwrite_id,
355 struct discord_delete_channel_permission *params,
356 struct discord_ret *ret);
357
366CCORDcode discord_trigger_typing_indicator(struct discord *client,
367 u64snowflake channel_id,
368 struct discord_ret *ret);
369
380CCORDcode discord_follow_news_channel(
381 struct discord *client,
382 u64snowflake channel_id,
383 struct discord_follow_news_channel *params,
384 struct discord_ret_followed_channel *ret);
385
394CCORDcode discord_get_pinned_messages(struct discord *client,
395 u64snowflake channel_id,
396 struct discord_ret_messages *ret);
397
408CCORDcode discord_pin_message(struct discord *client,
409 u64snowflake channel_id,
410 u64snowflake message_id,
411 struct discord_pin_message *params,
412 struct discord_ret *ret);
413
424CCORDcode discord_unpin_message(struct discord *client,
425 u64snowflake channel_id,
426 u64snowflake message_id,
427 struct discord_unpin_message *params,
428 struct discord_ret *ret);
429
440CCORDcode discord_group_dm_add_recipient(
441 struct discord *client,
442 u64snowflake channel_id,
443 u64snowflake user_id,
444 struct discord_group_dm_add_recipient *params,
445 struct discord_ret *ret);
446
456CCORDcode discord_group_dm_remove_recipient(struct discord *client,
457 u64snowflake channel_id,
458 u64snowflake user_id,
459 struct discord_ret *ret);
460
472CCORDcode discord_start_thread_with_message(
473 struct discord *client,
474 u64snowflake channel_id,
475 u64snowflake message_id,
476 struct discord_start_thread_with_message *params,
477 struct discord_ret_channel *ret);
478
489CCORDcode discord_start_thread_without_message(
490 struct discord *client,
491 u64snowflake channel_id,
492 struct discord_start_thread_without_message *params,
493 struct discord_ret_channel *ret);
494
504CCORDcode discord_join_thread(struct discord *client,
505 u64snowflake channel_id,
506 struct discord_ret *ret);
507
518CCORDcode discord_add_thread_member(struct discord *client,
519 u64snowflake channel_id,
520 u64snowflake user_id,
521 struct discord_ret *ret);
522
532CCORDcode discord_leave_thread(struct discord *client,
533 u64snowflake channel_id,
534 struct discord_ret *ret);
535
547CCORDcode discord_remove_thread_member(struct discord *client,
548 u64snowflake channel_id,
549 u64snowflake user_id,
550 struct discord_ret *ret);
551
562CCORDcode discord_list_thread_members(struct discord *client,
563 u64snowflake channel_id,
564 struct discord_ret_thread_members *ret);
565
577CCORDcode discord_list_active_threads(
578 struct discord *client,
579 u64snowflake channel_id,
580 struct discord_ret_thread_response_body *ret);
581
592CCORDcode discord_list_public_archived_threads(
593 struct discord *client,
594 u64snowflake channel_id,
595 u64unix_ms before,
596 int limit,
597 struct discord_ret_thread_response_body *ret);
598
609CCORDcode discord_list_private_archived_threads(
610 struct discord *client,
611 u64snowflake channel_id,
612 u64unix_ms before,
613 int limit,
614 struct discord_ret_thread_response_body *ret);
615
626CCORDcode discord_list_joined_private_archived_threads(
627 struct discord *client,
628 u64snowflake channel_id,
629 u64unix_ms before,
630 int limit,
631 struct discord_ret_thread_response_body *ret);
632
646void discord_embed_set_title(struct discord_embed *embed, char format[], ...);
647
657void discord_embed_set_description(struct discord_embed *embed,
658 char format[],
659 ...);
660
670void discord_embed_set_url(struct discord_embed *embed, char format[], ...);
671
683void discord_embed_set_thumbnail(struct discord_embed *embed,
684 char url[],
685 char proxy_url[],
686 int height,
687 int width);
699void discord_embed_set_image(struct discord_embed *embed,
700 char url[],
701 char proxy_url[],
702 int height,
703 int width);
704
716void discord_embed_set_video(struct discord_embed *embed,
717 char url[],
718 char proxy_url[],
719 int height,
720 int width);
721
732void discord_embed_set_footer(struct discord_embed *embed,
733 char text[],
734 char icon_url[],
735 char proxy_icon_url[]);
736
746void discord_embed_set_provider(struct discord_embed *embed,
747 char name[],
748 char url[]);
749
761void discord_embed_set_author(struct discord_embed *embed,
762 char name[],
763 char url[],
764 char icon_url[],
765 char proxy_icon_url[]);
766
777void discord_embed_add_field(struct discord_embed *embed,
778 char name[],
779 char value[],
780 bool Inline);
781
797CCORDcode discord_get_channel_at_pos(struct discord *client,
798 u64snowflake guild_id,
799 enum discord_channel_types type,
800 int position,
801 struct discord_ret_channel *ret);
802
814void discord_overwrite_append(struct discord_overwrites *permission_overwrites,
815 u64snowflake id,
816 int type,
817 u64bitmask allow,
818 u64bitmask deny);
819
837#endif /* DISCORD_CHANNEL_H */
discord_channel_types
discord_channel_types
Definition: channel.h:48
CCORDcode
CCORDcode
Definition: error.h:12
u64snowflake
uint64_t u64snowflake
Snowflake datatype.
Definition: types.h:28
u64bitmask
uint64_t u64bitmask
Bitmask primitive.
Definition: types.h:35
u64unix_ms
uint64_t u64unix_ms
Unix time in milliseconds.
Definition: types.h:22
discord_embed_set_url
void discord_embed_set_url(struct discord_embed *embed, char format[],...)
Add URL to embed.
discord_embed_set_video
void discord_embed_set_video(struct discord_embed *embed, char url[], char proxy_url[], int height, int width)
Add video to embed.
discord_embed_set_footer
void discord_embed_set_footer(struct discord_embed *embed, char text[], char icon_url[], char proxy_icon_url[])
Add footer to embed.
discord_embed_set_description
void discord_embed_set_description(struct discord_embed *embed, char format[],...)
Add description to embed.
discord_embed_set_title
void discord_embed_set_title(struct discord_embed *embed, char format[],...)
Add title to embed.
discord_embed_set_author
void discord_embed_set_author(struct discord_embed *embed, char name[], char url[], char icon_url[], char proxy_icon_url[])
Add author to embed.
discord_embed_add_field
void discord_embed_add_field(struct discord_embed *embed, char name[], char value[], bool Inline)
Add field to embed.
discord_embed_set_image
void discord_embed_set_image(struct discord_embed *embed, char url[], char proxy_url[], int height, int width)
Add image to embed.
discord_embed_set_thumbnail
void discord_embed_set_thumbnail(struct discord_embed *embed, char url[], char proxy_url[], int height, int width)
Add thumbnail to embed.
discord_embed_set_provider
void discord_embed_set_provider(struct discord_embed *embed, char name[], char url[])
Add provider to embed.
discord_overwrite_append
void discord_overwrite_append(struct discord_overwrites *permission_overwrites, u64snowflake id, int type, u64bitmask allow, u64bitmask deny)
Append to an overwrite list.
discord_get_channel_at_pos
CCORDcode discord_get_channel_at_pos(struct discord *client, u64snowflake guild_id, enum discord_channel_types type, int position, struct discord_ret_channel *ret)
Get a guild's channel from its given numerical position.
discord_delete_message
CCORDcode discord_delete_message(struct discord *client, u64snowflake channel_id, u64snowflake message_id, struct discord_delete_message *params, struct discord_ret *ret)
Delete a message.
discord_add_thread_member
CCORDcode discord_add_thread_member(struct discord *client, u64snowflake channel_id, u64snowflake user_id, struct discord_ret *ret)
Adds another member to an un-archived thread.
discord_create_message
CCORDcode discord_create_message(struct discord *client, u64snowflake channel_id, struct discord_create_message *params, struct discord_ret_message *ret)
Post a message to a guild text or DM channel.
discord_start_thread_with_message
CCORDcode discord_start_thread_with_message(struct discord *client, u64snowflake channel_id, u64snowflake message_id, struct discord_start_thread_with_message *params, struct discord_ret_channel *ret)
Creates a new thread from an existing message.
discord_join_thread
CCORDcode discord_join_thread(struct discord *client, u64snowflake channel_id, struct discord_ret *ret)
Adds the current user to an un-archived thread.
discord_delete_own_reaction
CCORDcode discord_delete_own_reaction(struct discord *client, u64snowflake channel_id, u64snowflake message_id, u64snowflake emoji_id, const char emoji_name[], struct discord_ret *ret)
Delete a reaction the current user has made for the message.
discord_delete_user_reaction
CCORDcode discord_delete_user_reaction(struct discord *client, u64snowflake channel_id, u64snowflake message_id, u64snowflake user_id, u64snowflake emoji_id, const char emoji_name[], struct discord_ret *ret)
Deletes another user's reaction.
discord_pin_message
CCORDcode discord_pin_message(struct discord *client, u64snowflake channel_id, u64snowflake message_id, struct discord_pin_message *params, struct discord_ret *ret)
Pin a message to a channel.
discord_get_reactions
CCORDcode discord_get_reactions(struct discord *client, u64snowflake channel_id, u64snowflake message_id, u64snowflake emoji_id, const char emoji_name[], struct discord_get_reactions *params, struct discord_ret_users *ret)
Get a list of users that reacted with given emoji.
discord_start_thread_without_message
CCORDcode discord_start_thread_without_message(struct discord *client, u64snowflake channel_id, struct discord_start_thread_without_message *params, struct discord_ret_channel *ret)
Creates a new thread that is not connected to an existing message.
discord_remove_thread_member
CCORDcode discord_remove_thread_member(struct discord *client, u64snowflake channel_id, u64snowflake user_id, struct discord_ret *ret)
Removes another member from a un-archived thread.
discord_delete_channel_permission
CCORDcode discord_delete_channel_permission(struct discord *client, u64snowflake channel_id, u64snowflake overwrite_id, struct discord_delete_channel_permission *params, struct discord_ret *ret)
Delete a channel permission overwrite for a user or role in a channel.
discord_list_public_archived_threads
CCORDcode discord_list_public_archived_threads(struct discord *client, u64snowflake channel_id, u64unix_ms before, int limit, struct discord_ret_thread_response_body *ret)
Get public archived threads in a given channel.
discord_group_dm_add_recipient
CCORDcode discord_group_dm_add_recipient(struct discord *client, u64snowflake channel_id, u64snowflake user_id, struct discord_group_dm_add_recipient *params, struct discord_ret *ret)
Adds a recipient to a Group DM using their access token.
discord_get_pinned_messages
CCORDcode discord_get_pinned_messages(struct discord *client, u64snowflake channel_id, struct discord_ret_messages *ret)
Get all pinned messages in the channel.
discord_get_channel_message
CCORDcode discord_get_channel_message(struct discord *client, u64snowflake channel_id, u64snowflake message_id, struct discord_ret_message *ret)
Get a specific message in the channel.
discord_modify_channel
CCORDcode discord_modify_channel(struct discord *client, u64snowflake channel_id, struct discord_modify_channel *params, struct discord_ret_channel *ret)
Update a channel's settings.
discord_edit_channel_permissions
CCORDcode discord_edit_channel_permissions(struct discord *client, u64snowflake channel_id, u64snowflake overwrite_id, struct discord_edit_channel_permissions *params, struct discord_ret *ret)
Edit the channel permission overwrites for a user or role in a channel.
discord_leave_thread
CCORDcode discord_leave_thread(struct discord *client, u64snowflake channel_id, struct discord_ret *ret)
Removes the current user from a un-archived thread.
discord_list_joined_private_archived_threads
CCORDcode discord_list_joined_private_archived_threads(struct discord *client, u64snowflake channel_id, u64unix_ms before, int limit, struct discord_ret_thread_response_body *ret)
Get private archived threads that current user has joined.
discord_get_channel
CCORDcode discord_get_channel(struct discord *client, u64snowflake channel_id, struct discord_ret_channel *ret)
Get channel from given id.
discord_list_active_threads
CCORDcode discord_list_active_threads(struct discord *client, u64snowflake channel_id, struct discord_ret_thread_response_body *ret)
Get all active threads in a given channel.
discord_group_dm_remove_recipient
CCORDcode discord_group_dm_remove_recipient(struct discord *client, u64snowflake channel_id, u64snowflake user_id, struct discord_ret *ret)
Removes a recipient from a Group DM.
discord_list_thread_members
CCORDcode discord_list_thread_members(struct discord *client, u64snowflake channel_id, struct discord_ret_thread_members *ret)
Get members from a given thread channel.
discord_bulk_delete_messages
CCORDcode discord_bulk_delete_messages(struct discord *client, u64snowflake channel_id, struct discord_bulk_delete_messages *params, struct discord_ret *ret)
Delete multiple messages in a single request.
discord_edit_message
CCORDcode discord_edit_message(struct discord *client, u64snowflake channel_id, u64snowflake message_id, struct discord_edit_message *params, struct discord_ret_message *ret)
Edit a previously sent message.
discord_get_channel_invites
CCORDcode discord_get_channel_invites(struct discord *client, u64snowflake channel_id, struct discord_ret_invites *ret)
Get invites (with invite metadata) for the channel.
discord_delete_channel
CCORDcode discord_delete_channel(struct discord *client, u64snowflake channel_id, struct discord_delete_channel *params, struct discord_ret_channel *ret)
Delete a channel, or close a private message.
discord_delete_all_reactions
CCORDcode discord_delete_all_reactions(struct discord *client, u64snowflake channel_id, u64snowflake message_id, struct discord_ret *ret)
Deletes all reactions from message.
discord_create_reaction
CCORDcode discord_create_reaction(struct discord *client, u64snowflake channel_id, u64snowflake message_id, u64snowflake emoji_id, const char emoji_name[], struct discord_ret *ret)
Create a reaction for the message.
discord_crosspost_message
CCORDcode discord_crosspost_message(struct discord *client, u64snowflake channel_id, u64snowflake message_id, struct discord_ret_message *ret)
Crosspost a message in a News Channel to following channels.
discord_list_private_archived_threads
CCORDcode discord_list_private_archived_threads(struct discord *client, u64snowflake channel_id, u64unix_ms before, int limit, struct discord_ret_thread_response_body *ret)
Get private archived threads in a given channel.
discord_follow_news_channel
CCORDcode discord_follow_news_channel(struct discord *client, u64snowflake channel_id, struct discord_follow_news_channel *params, struct discord_ret_followed_channel *ret)
Follow a News Channel to send messages to a target channel.
discord_create_channel_invite
CCORDcode discord_create_channel_invite(struct discord *client, u64snowflake channel_id, struct discord_create_channel_invite *params, struct discord_ret_invite *ret)
Create a new invite for the channel.
discord_unpin_message
CCORDcode discord_unpin_message(struct discord *client, u64snowflake channel_id, u64snowflake message_id, struct discord_unpin_message *params, struct discord_ret *ret)
Unpin a message from a channel.
discord_delete_all_reactions_for_emoji
CCORDcode discord_delete_all_reactions_for_emoji(struct discord *client, u64snowflake channel_id, u64snowflake message_id, u64snowflake emoji_id, const char emoji_name[], struct discord_ret *ret)
Deletes all the reactions for a given emoji on message.
discord_get_channel_messages
CCORDcode discord_get_channel_messages(struct discord *client, u64snowflake channel_id, struct discord_get_channel_messages *params, struct discord_ret_messages *ret)
Get messages for a given channel.
discord_trigger_typing_indicator
CCORDcode discord_trigger_typing_indicator(struct discord *client, u64snowflake channel_id, struct discord_ret *ret)
Post a typing indicator for the specified channel.
discord_bulk_delete_messages
Definition: channel.h:755
discord_create_channel_invite
Definition: channel.h:779
discord_create_message
Definition: channel.h:683
discord_delete_channel_permission
Definition: channel.h:815
discord_delete_channel
Definition: channel.h:660
discord_delete_message
Definition: channel.h:750
discord_edit_channel_permissions
Definition: channel.h:762
discord_edit_message
Definition: channel.h:727
discord_embed
Definition: channel.h:397
discord_follow_news_channel
Definition: channel.h:820
discord_get_channel_messages
Definition: channel.h:664
discord_get_reactions
Definition: channel.h:716
discord_group_dm_add_recipient
Definition: channel.h:835
discord_modify_channel
Definition: channel.h:587
discord_overwrites
Definition: channel.h:313
discord_pin_message
Definition: channel.h:826
discord_ret_channel
Request's return context.
Definition: discord-response.h:84
discord_ret_followed_channel
Request's return context.
Definition: discord-response.h:88
discord_ret_invite
Request's return context.
Definition: discord-response.h:132
discord_ret_invites
Request's return context.
Definition: discord-response.h:133
discord_ret_message
Request's return context.
Definition: discord-response.h:86
discord_ret_messages
Request's return context.
Definition: discord-response.h:87
discord_ret_thread_members
Request's return context.
Definition: discord-response.h:89
discord_ret_thread_response_body
Request's return context.
Definition: discord-response.h:90
discord_ret_users
Request's return context.
Definition: discord-response.h:151
discord_ret
Request's return context.
Definition: discord-response.h:54
discord_start_thread_with_message
Definition: channel.h:842
discord_start_thread_without_message
Definition: channel.h:859
discord_unpin_message
Definition: channel.h:830
discord
The Discord client handler.
Definition: discord-internal.h:1182