7 разделов
Заклинания, бестиарий, классы, расы, предыстории, черты и предметы.
D&D 5e · REST API
Справочник приключенца
Официальные материалы D&D в простом JSON API. Ищите заклинания, существ, классы, черты и предметы — без лишних бросков.
СОСТОЯНИЕ СЕРВИСА
Проверяем API…
GET /health
—Заклинаний
—Существ
—Классов
—Рас
—Предысторий
—Черт
—Предметов
Фильтры и поиск
Сочетайте параметры, ищите на русском или английском и листайте результаты.
Предсказуемый JSON
Структурированные описания, страницы результатов и отдельные карточки всех разделов.
БЫСТРЫЙ СТАРТ
Нажмите пример, чтобы выполнить запрос
Проверьте API на живых запросах
Готовые примеры
Запросы к актуальным маршрутам API
Данные берутся из локального кэша. Запросы к dnd.su во время работы API не выполняются.
Заклинания
Официальные заклинания D&D: уровень, школа, компоненты, классы, структурированное описание с таблицами.
База: https://api.5elexir.su
GET
/spells
Список заклинаний
Возвращает заклинания по фильтрам. Без параметров — первую страницу. Списочные фильтры можно передавать несколько раз: значения внутри одного фильтра объединяются по ИЛИ, разные фильтры — по И.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| level | int[] | Уровень 0–9 (0 = заговор). Напр. level=1&level=2 |
| class | string[] | Класс на RU или EN: волшебник / wizard |
| school | string[] | Школа на RU или EN: воплощение / evocation |
| subclass | string[] | Подкласс (RU), как в карточке: «исчадие (колдун)» |
| source | string[] | Источник (EN): Player's Handbook |
| concentration | bool | Требуется ли концентрация |
| ritual | bool | Является ли ритуалом |
| search | string | Полнотекст по названию (RU+EN) и описанию. Совпадения по названию идут первыми |
| limit | int | Размер страницы, 1–1000. По умолчанию 10 |
| offset | int | Сколько записей пропустить. По умолчанию 0 |
| exclude_level | int[] | Исключить уровни |
| exclude_class | string[] | Исключить классы |
| exclude_school | string[] | Исключить школы |
| exclude_subclass | string[] | Исключить подклассы |
| exclude_source | string[] | Исключить источники |
GET
/spells/{slug}
Одно заклинание
Полная карточка заклинания по его slug.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| slug | string | Идентификатор из URL, напр. 205-fireball |
GET
/filters
Доступные значения фильтров
Справочник значений для class / school (RU↔EN), level, source.
Структура объекта
| Поле | Тип | Описание |
|---|---|---|
| id | int | Внутренний id заклинания |
| slug | string | Идентификатор для URL |
| name_en | string | Название (английское) |
| name_ru | string | Название (русское) |
| level | int | Уровень 0–9 (0 = заговор) |
| school | string | Школа магии (EN-ключ) |
| ritual | bool | Ритуал |
| concentration | bool | Требует концентрации |
| casting_time | string[] | Время накладывания (альтернативы) |
| duration | string[] | Длительность (альтернативы) |
| range | string | Дистанция («На себя» очищена от скобок) |
| components | object | {verbal, somatic, material, material_description} |
| classes | string[] | Классы (EN-ключи) |
| subclasses | string[] | Подклассы (RU) |
| sources | string[] | Источники (EN) |
| description | block[] | Блоки описания (см. примечания) |
| higher_levels | block[] | Блоки «На больших уровнях» |
| url | string | Ссылка на dnd.su |
Примечания
- Поля description и higher_levels — массивы структурных блоков, а не плоский текст. Каждый блок имеет type: paragraph | heading | list | table.
- Блок table: { type:'table', headers:[...], rows:[[...]] } — первая строка это заголовки. Блок list: { ordered:bool, items:[...] }.
- Текст внутри блоков хранит инлайн-Markdown: **жирный**, *курсив*.
- Ответ списка: { count, total, limit, offset, results } — count это размер текущей страницы, total — всего совпадений по фильтрам. Без параметров возвращаются первые 10 заклинаний, а не все; дальше листайте через offset.
Бестиарий
Официальные монстры D&D: размер, тип, КД, хиты, характеристики, спасброски, чувства, способности, действия и легендарные действия.
База: https://api.5elexir.su
GET
/bestiary
Список монстров
Возвращает монстров по фильтрам. Без параметров — первую страницу. Списочные фильтры можно передавать несколько раз: значения внутри одного фильтра объединяются по ИЛИ, разные фильтры — по И.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| type | string[] | Тип на RU или EN: дракон / dragon, нежить / undead |
| size | string[] | Размер на RU или EN: большой / large |
| cr | string[] | Опасность точно: 0, 1/8, 1/4, 1/2, 1…30 |
| cr_min | string | Опасность не ниже (напр. cr_min=5) |
| cr_max | string | Опасность не выше (напр. cr_max=10) |
| source | string[] | Источник (EN): Monster Manual |
| search | string | Полнотекст по названию (RU+EN) и тексту способностей. Совпадения по названию идут первыми |
| limit | int | Размер страницы, 1–1000. По умолчанию 10 |
| offset | int | Сколько записей пропустить. По умолчанию 0 |
| exclude_type | string[] | Исключить типы |
| exclude_size | string[] | Исключить размеры |
| exclude_source | string[] | Исключить источники |
GET
/bestiary/{slug}
Один монстр
Полная карточка монстра по его slug.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| slug | string | Идентификатор из URL, напр. 88-allosaurus |
GET
/bestiary/filters
Доступные значения фильтров
Справочник значений для type / size (RU↔EN), cr, source.
Структура объекта
| Поле | Тип | Описание |
|---|---|---|
| id | int | Внутренний id монстра |
| slug | string | Идентификатор для URL |
| name_en | string | Название (английское) |
| name_ru | string | Название (русское) |
| size | string | Размер (EN-ключ: tiny…gargantuan) |
| type | string | Тип существа (EN-ключ: dragon, undead…) |
| alignment | string | Мировоззрение (RU) |
| armor_class | string | Класс Доспеха |
| hit_points | string | Хиты с формулой, напр. «51 (6к10+18)» |
| speed | string | Скорость (все виды) |
| abilities | object | {str, dex, con, int, wis, cha} = {score, mod} |
| saving_throws | string | Спасброски (может быть null) |
| skills | string | Навыки (может быть null) |
| damage_resistances | string | Сопротивление урону (null если нет) |
| damage_immunities | string | Иммунитет к урону (null если нет) |
| damage_vulnerabilities | string | Уязвимость к урону (null если нет) |
| condition_immunities | string | Иммунитет к состоянию (null если нет) |
| senses | string | Чувства |
| languages | string | Языки (может быть null) |
| challenge_rating | string | Опасность, напр. «2 (450 опыта)» |
| cr_value | number | Числовое значение опасности (0.5, 2…) для фильтров |
| environment | string | Местность обитания (null если нет) |
| sections | section[] | Блоки statblock: способности, действия, легендарные… (см. ниже) |
| description | block[] | Блоки описания монстра |
| sources | string[] | Источники (EN) |
| url | string | Ссылка на dnd.su |
Примечания
- sections — массив { title, blocks }: title это «Действия», «Легендарные действия», «Логово» и т.п. (null = особые способности). blocks — те же структурные блоки, что и в заклинаниях (paragraph / heading / list / table).
- Текст внутри блоков хранит инлайн-Markdown: **жирный**, *курсив*.
- Фильтр cr принимает дроби как строку: 1/8, 1/4, 1/2. Для диапазона используйте cr_min / cr_max.
- Ответ списка: { count, total, limit, offset, results } — count это размер текущей страницы, total — всего совпадений по фильтрам. Без параметров возвращаются первые 10 монстров, а не весь бестиарий; дальше листайте через offset.
СПРАВОЧНИК ПЕРСОНАЖА
Классы
Классы и подклассы: владения, особенности и структурированные разделы.
База: https://api.5elexir.su
GET/classesСписок классов
Параметры: search, source, exclude_source, limit
(1–1000, по умолчанию 10), offset. Источники можно получить в /classes/filters.
GET/classes/{slug}Карточка класса
Полная запись класса по slug. Например, 88-bard. Возвращает владения, описание, разделы и
источники.
GET/classes/filtersФильтры классов
Возвращает список доступных официальных источников для параметра source.
СПРАВОЧНИК ПЕРСОНАЖА
Расы
Расы и происхождения с описаниями, особенностями и источниками.
База: https://api.5elexir.su
GET/racesСписок рас
Параметры: search, source, exclude_source, limit
(1–1000, по умолчанию 10), offset. Источники доступны через /races/filters.
GET/races/{slug}Карточка расы
Полная запись расы по slug. Пример: 92-aarakocra.
GET/races/filtersФильтры рас
Возвращает список доступных официальных источников для параметра source.
СПРАВОЧНИК ПЕРСОНАЖА
Предыстории
Прошлое персонажа, владения, снаряжение и сюжетные зацепки.
База: https://api.5elexir.su
GET/backgroundsСписок предысторий
Параметры: search, source, exclude_source, limit
(1–1000, по умолчанию 10), offset. Источники доступны через /backgrounds/filters.
GET/backgrounds/{slug}Карточка предыстории
Полная запись предыстории по slug. Пример: 802-golgari-agent.
GET/backgrounds/filtersФильтры предысторий
Возвращает список доступных официальных источников для параметра source.
СПРАВОЧНИК ПЕРСОНАЖА
Черты
Черты и дополнительные возможности персонажей с требованиями и описаниями.
База: https://api.5elexir.su
GET/featsСписок черт
Параметры: search, source, exclude_source, limit
(1–1000, по умолчанию 10), offset. Источники доступны через /feats/filters.
GET/feats/{slug}Карточка черты
Полная запись черты по slug. Пример: 222-agent-of-order.
GET/feats/filtersФильтры черт
Возвращает список доступных официальных источников для параметра source.
СНАРЯЖЕНИЕ
Магические предметы
Предметы, редкость, настройка и ориентировочная стоимость.
База: https://api.5elexir.su
GET/itemsСписок предметов
Фильтры: type, rarity, attunement, price_min,
price_max, search, source, exclude_source. Тип и
редкость принимают RU или EN; цены задаются в зм. Пагинация: limit (1–1000, по умолчанию 10),
offset.
GET/items/{slug}Карточка предмета
Полная запись магического предмета по slug. Пример: 94-ring-of-protection.
GET/items/filtersФильтры предметов
Возвращает словари типов и редкости (RU↔EN), варианты настройки и доступные официальные источники.