Коды ошибок REST API

Ответы с HTTP-статусами 4xx и 5xx содержат JSON вида:

{
  "code": "UNKNOWN_CHANNEL",
  "message": "Канал не найден"
}

Ориентируйтесь в первую очередь на code (стабильный машиночитаемый идентификатор), message — человеко-читаемая подсказка на языке клиента и может меняться.

Категории

Большинство кодов имеют общий префикс, по которому понятно, что произошло:

• UNKNOWN_* — Объект не найден
• MAX_* — Превышен лимит
• CANNOT_* — Действие запрещено в текущем контексте
• INVALID_* — Невалидные данные
• MISSING_* — Отсутствует обязательное поле или право

Все коды

• GENERAL_ERROR
• UNKNOWN_CHANNEL
• UNKNOWN_GUILD
• UNKNOWN_INVITE
• UNKNOWN_MEMBER
• UNKNOWN_MESSAGE
• UNKNOWN_ROLE
• UNKNOWN_USER
• UNKNOWN_EMOJI
• UNKNOWN_PACK
• UNKNOWN_STICKER
• UNKNOWN_WEBHOOK
• UNKNOWN_FAVORITE_MEME
• EXPLICIT_CONTENT_CANNOT_BE_SENT
• MAX_GUILDS
• MAX_FRIENDS
• MAX_PINS_PER_CHANNEL
• MAX_GUILD_ROLES
• MAX_WEBHOOKS
• MAX_EMOJIS
• MAX_STICKERS
• MAX_PACKS
• MAX_REACTIONS
• MAX_GUILD_CHANNELS
• MAX_CATEGORY_CHANNELS
• MAX_INVITES
• MAX_ANIMATED_EMOJIS
• MAX_GUILD_MEMBERS
• MAX_WEBHOOKS_PER_GUILD
• RATE_LIMITED
• SLOWMODE_RATE_LIMITED
• CAPTCHA_REQUIRED
• INVALID_CAPTCHA
• UNAUTHORIZED
• USER_BANNED_FROM_GUILD
• USER_IP_BANNED_FROM_GUILD
• MISSING_ACCESS
• CANNOT_EXECUTE_ON_DM
• CANNOT_EDIT_OTHER_USER_MESSAGE
• CANNOT_SEND_EMPTY_MESSAGE
• CANNOT_SEND_MESSAGES_TO_USER
• CANNOT_SEND_MESSAGES_IN_NON_TEXT_CHANNEL
• COMMUNICATION_DISABLED
• MISSING_PERMISSIONS
• INVALID_FORM_BODY
• CANNOT_MODIFY_SYSTEM_WEBHOOK
• TWO_FACTOR_REQUIRED
• FRIEND_REQUEST_BLOCKED
• CANNOT_SEND_FRIEND_REQUEST_TO_BLOCKED_USER
• BOTS_CANNOT_HAVE_FRIENDS
• CANNOT_SEND_FRIEND_REQUEST_TO_SELF
• ALREADY_FRIENDS
• TWO_FA_NOT_ENABLED
• MISSING_ACL
• IP_BANNED
• USER_NOT_IN_VOICE
• CANNOT_MODIFY_VOICE_STATE
• VOICE_CHANNEL_FULL
• ACCOUNT_DISABLED
• ACCOUNT_SCHEDULED_FOR_DELETION
• INVALID_PHONE_NUMBER
• PHONE_ALREADY_USED
• PHONE_VERIFICATION_REQUIRED
• INVALID_PHONE_VERIFICATION_CODE
• PHONE_RATE_LIMIT_EXCEEDED
• SMS_MFA_NOT_ENABLED
• SMS_MFA_REQUIRES_TOTP
• PHONE_REQUIRED_FOR_SMS_MFA
• INVALID_WEBAUTHN_CREDENTIAL
• WEBAUTHN_CREDENTIAL_LIMIT_REACHED
• UNKNOWN_WEBAUTHN_CREDENTIAL
• PASSKEY_AUTHENTICATION_FAILED
• PASSKEYS_DISABLED
• GUILD_VERIFICATION_REQUIRED
• ACCOUNT_SUSPICIOUS_ACTIVITY
• PREMIUM_PURCHASE_BLOCKED
• PREMIUM_REQUIRED
• HARVEST_ON_COOLDOWN
• HARVEST_EXPIRED
• HARVEST_FAILED
• HARVEST_NOT_READY
• UNKNOWN_HARVEST
• CHANNEL_INDEXING
• AUDIT_LOG_INDEXING
• UNKNOWN_GIFT_CODE
• GIFT_CODE_ALREADY_REDEEMED
• PAYMENT_ERROR
• WEBHOOK_VERIFICATION_ERROR
• USER_OWNS_GUILDS
• FEATURE_TEMPORARILY_DISABLED
• INVITES_DISABLED
• GUILD_DISALLOWS_UNCLAIMED_ACCOUNTS
• TEMPORARY_INVITE_REQUIRES_PRESENCE
• MAX_GROUP_DM_RECIPIENTS
• MAX_GROUP_DMS
• NOT_FRIENDS_WITH_USER
• INVALID_CHANNEL_TYPE
• NSFW_CONTENT_AGE_RESTRICTED
• FILE_SIZE_TOO_LARGE
• CANNOT_REPORT_OWN_MESSAGE
• CANNOT_REPORT_YOURSELF
• CANNOT_REPORT_OWN_GUILD
• REPORT_BANNED
• MAX_BOOKMARKS
• MAX_PACK_EXPRESSIONS
• MAX_FAVORITE_MEMES
• CANNOT_SHRINK_RESERVED_SLOTS
• MEDIA_METADATA_ERROR
• NO_ACTIVE_CALL
• CALL_ALREADY_EXISTS
• INVALID_CHANNEL_TYPE_FOR_CALL
• UNCLAIMED_ACCOUNT_RESTRICTED
• INVALID_CLIENT
• INVALID_REQUEST
• INVALID_SCOPE
• UNSUPPORTED_RESPONSE_TYPE
• INVALID_GRANT
• ACCESS_DENIED
• INVALID_TOKEN
• SUDO_MODE_REQUIRED
• INVALID_SUDO_TOKEN
• INSTANCE_VERSION_MISMATCH
• INVALID_HANDOFF_CODE
• HANDOFF_CODE_EXPIRED
• NO_ACTIVE_SUBSCRIPTION
• UNKNOWN_VOICE_REGION
• UNKNOWN_VOICE_SERVER
• UNKNOWN_REPORT
• REPORT_ALREADY_RESOLVED
• TEST_HARNESS_DISABLED
• TEST_HARNESS_FORBIDDEN
• EMAIL_SERVICE_NOT_TESTABLE
• INVALID_FLAGS_FORMAT
• INVALID_ACLS_FORMAT
• ACLS_MUST_BE_NON_EMPTY
• UNKNOWN_USER_FLAG
• UNKNOWN_SUSPICIOUS_FLAG
• INVALID_SUSPICIOUS_FLAGS_FORMAT
• NO_PENDING_DELETION
• INVALID_TIMESTAMP
• INVALID_BOT_FLAG
• CANNOT_TRANSFER_OWNERSHIP_TO_BOT
• BOT_USER_AUTH_ENDPOINT_ACCESS_DENIED
• BOT_USER_AUTH_SESSION_CREATION_DENIED
• INVALID_SYSTEM_FLAG
• MISSING_OAUTH_FIELDS
• DELETION_FAILED
• PROCESSING_FAILED
• UPDATE_FAILED
• CREATION_FAILED
• INVALID_DSA_REPORT_TARGET
• INVALID_DSA_TICKET
• INVALID_DSA_VERIFICATION_CODE
• PACK_ACCESS_DENIED
• INVALID_PACK_TYPE
• BAD_GATEWAY
• GATEWAY_TIMEOUT
• SERVICE_UNAVAILABLE