API Discord
Этот API для серверов Discord находит публичные серверы по ссылке-приглашению или ключевому слову и возвращает их в формате JSON. Он также просматривает каталог серверов и ищет пользователей по имени.
Передайте код или URL приглашения, чтобы получить публичные метаданные сервера, не вступая в сообщество.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Discord: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите серверы Discord по ключевому слову. | $1.39 за 1 000 запросов | Норма |
Каталогdirectory | Просматривайте каталог серверов Discord, при желании в одной категории. | $1.39 за 1 000 запросов | Норма |
Серверserver | Получите по коду или ссылке приглашения Discord название и описание сервера, число участников и пользователей онлайн, бусты, уровень верификации, канал, автора приглашения и срок его действия. | $1.39 за 1 000 запросов | Норма |
Поиск пользователейsearch_users | Ищите пользователей Discord по имени пользователя или отображаемому имени и получайте ID, аватар, тег клана, дату создания и число серверов и приглашений каждого аккаунта. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Discord?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите серверы Discord по ключевому слову. Получите описание, число участников и пользователей онлайн, число бустов, язык, категории, уровень верификации и флаг NSFW. Поиск не охватывает сообщения внутри серверов и не открывает закрытые сообщества. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · name · url · text · member_count · online_count · boost_count · vanity_url_code · language · categories · keywords · icon_url · banner_url · verification_level · is_nsfw · created_at · directory_url · platform |
directoryКаталог Просматривайте каталог серверов Discord, при желании в одной категории. Для каждого сервера указаны описание, число участников и пользователей онлайн, бусты, язык, теги и уровень верификации. | category | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · name · url · text · member_count · online_count · boost_count · vanity_url_code · language · categories · keywords · icon_url · banner_url · verification_level · is_nsfw · created_at · directory_url · platform | |
serverСервер Получите по коду или ссылке приглашения Discord название и описание сервера, число участников и пользователей онлайн, бусты, уровень верификации, канал, автора приглашения и срок его действия. Проверка приглашения не приводит к вступлению на сервер, а null в | invite | code, url | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · name · url · text · member_count · online_count · boost_count · invite_code · vanity_url_code · icon_url · banner_url · verification_level · nsfw_level · channel_name · channel_type · inviter_username · inviter_name · expires_at · platform |
search_usersПоиск пользователей Ищите пользователей Discord по имени пользователя или отображаемому имени и получайте ID, аватар, тег клана, дату создания и число серверов и приглашений каждого аккаунта. Это не глобальный поиск по участникам, и личные связи не раскрываются. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · username · name · avatar · clan_tag · server_count · invite_count · created_at · platform |
Что означают параметры действия search в API Discord?
Находите серверы Discord по ключевому слову. Получите описание, число участников и пользователей онлайн, число бустов, язык, категории, уровень верификации и флаг NSFW. Поиск не охватывает сообщения внутри серверов и не открывает закрытые сообщества.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковый запрос: в search ищет публичные серверы Discord, в search_users ищет публичных пользователей по имени пользователя и отображаемому имени. Сообщения в каналах не индексируются, доступ к приватным серверам не предоставляется.Discord Discover: как находить серверы сообществ — Официальная документация Discord описывает Discover Servers как раздел с серверами сообществ, открытыми для поиска, которые можно просматривать по категориям. Это объясняет понятия сервера, категории и поиска, но не означает, что API гарантирует воспроизведение экспериментальных вариантов интерфейса клиента или полный охват каталога. · Проверено
Что означают параметры действия directory в API Discord?
Просматривайте каталог серверов Discord, при желании в одной категории. Для каждого сервера указаны описание, число участников и пользователей онлайн, бусты, язык, теги и уровень верификации. category принимает gaming, entertainment, education, music или science-and-tech. Нераспознанные значения игнорируются.
categoryНеобязательный- Фильтрует поиск серверов в directory по предустановленным значениям: gaming, entertainment, education, music или science-and-tech. Если параметр не задан, возвращаются результаты каталога без фильтра; нераспознанные категории игнорируются.Категории серверов Discord и границы поиска — Официальная документация Discord перечисляет категории сообществ, например игры, музыку и развлечения. Поддерживаются ровно те категории, что перечислены на этой странице; категории и сортировка из устаревшей документации Discovery не используются. · Проверено
Что означают параметры действия server в API Discord?
Получите по коду или ссылке приглашения Discord название и описание сервера, число участников и пользователей онлайн, бусты, уровень верификации, канал, автора приглашения и срок его действия. Проверка приглашения не приводит к вступлению на сервер, а null в expires_at означает, что приглашение бессрочное.
inviteОбязательный- Определяет целевой сервер по коду приглашения или полному URL (discord.gg/<code> или discord.com/invite/<code>). Действие server считывает публичные метаданные, связанные с приглашением, не присоединяясь к серверу; истёкшее или недействительное приглашение не означает, что сервер не существует.Приглашения Discord: код приглашения, сервер и канал являются разными объектами — В официальных объектах Invite в Discord поля `code`, `guild`, `channel`, `inviter` и `expires_at` разделены, а возвращаемые приглашениями данные о числе участников считаются приблизительными. Этот источник поясняет связи объектов и ограничения точности счётчиков, но не означает поддержки создания или удаления приглашений либо управления пользователями, которым они предназначены. · Проверено
codeНеобязательный- Принимает код из ссылки-приглашения как псевдоним параметра invite для совместимости. Обязательный параметр invite всё равно нужно передать; поле не принимает коды подтверждения, токены ботов и ID серверов.
urlНеобязательный- Псевдоним параметра invite для совместимости, принимающий полную ссылку-приглашение Discord. Обязательный параметр invite всё равно нужно передать; ссылки на сообщения в каналах не считаются действительными приглашениями.
Что означают параметры действия search_users в API Discord?
Ищите пользователей Discord по имени пользователя или отображаемому имени и получайте ID, аватар, тег клана, дату создания и число серверов и приглашений каждого аккаунта. Это не глобальный поиск по участникам, и личные связи не раскрываются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковый запрос: в search ищет публичные серверы Discord, в search_users ищет публичных пользователей по имени пользователя и отображаемому имени. Сообщения в каналах не индексируются, доступ к приватным серверам не предоставляется.Discord: уникальные имена пользователей, отображаемые имена и никнеймы на сервере — Официальные источники Discord различают уникальные имена пользователей, редактируемые отображаемые имена и никнеймы на сервере, которые имеют приоритет при показе. Это различие поясняет поля в возвращаемых результатах, но не означает наличия глобального каталога пользователей или возможности проверять членство на серверах. · Проверено
Как использовать API Discord
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"discord","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Discord
Какие данные можно получить через API Discord?
Укажите в platform значение discord. В текущем каталоге: поиск, каталог, сервер и поиск пользователей. Эти названия действий соответствуют разным объектам или представлениям Discord; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Discord?
Поисковый запрос: в search ищет публичные серверы Discord, в search_users ищет публичных пользователей по имени пользователя и отображаемому имени. Сообщения в каналах не индексируются, доступ к приватным серверам не предоставляется. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Discord?
Объявленная схема включает name, text, member_count и online_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Discord возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.