Skip to content
Floodilka · Bots

Resources Overview

The Floodilka REST API is organised around several key resources. This page is an index for quick navigation.

Basics

Section titled “Basics”
  • Base URL: https://floodilka.com/api/v1
  • Format: JSON in request bodies and responses
  • Authentication: Authorization: Bot <token> or Bearer <access_token> — see Authentication
  • Limits: global + bucket, 429 with Retry-After — see Rate limits
  • Errors: { "code": "...", "message": "..." } — see Error codes

Resources

Section titled “Resources”
UsersUser object, @me, profile management.
GuildsGuilds, members, roles, bans.
ChannelsChannel types, permission overwrites, settings.
MessagesMessages, reactions, attachments, embeds.
OAuth2Applications, scopes, tokens.
InvitesInvite codes and metadata.
WebhooksIncoming and outgoing webhooks.
GatewayFetch the WebSocket URL before connecting.

Snowflake IDs

Section titled “Snowflake IDs”

Every resource ID is a 64-bit snowflake. Never parse them as numbers in JavaScript (precision loss) — use BigInt or treat them as strings. Details: Snowflakes.