ReManga API — документация API Реманга

Неофициальная русскоязычная документация и генератор справочника API

Русскоязычная документация ReManga API (API Реманга): справочник HTTP-методов и маршрутов сайта ReManga, примеры запросов и открытый генератор документации. Маршруты автоматически извлекаются из публичного JavaScript-клиента; справочник доступен в Markdown, JSON и CSV.

Сайт документации ReManga API · Справочник методов · Руководство и примеры · Скачать генератор

English: Unofficial ReManga API documentation and open-source endpoint reference generator. Browse HTTP methods and routes, request examples, and downloadable JSON/CSV snapshots. Documentation is in Russian; the portable Windows generator includes both GUI and CLI.

Репозиторий обновляется автоматически. Фоновый GitHub Actions runner каждые 12 часов проверяет frontend-сборку ReManga. При обнаружении новой версии документация пересобирается, изменения публикуются в main, а готовые Markdown, JSON и CSV добавляются в новый Release.

Проект не связан с администрацией ReManga и не является официальным SDK или официальной документацией.

Что находится в репозитории

• Полный справочник - 845 маршрутов, сгруппированных по разделам;
• Практическое руководство - каталог карточек, профиль и инвентарь пользователя;
• endpoints.json - полный машиночитаемый снимок;
• endpoints.csv - таблица для Excel и фильтрации;
• snapshot-summary.json - версия frontend-сборки и статистика;
• generator/ - открытые исходники основного Kotlin-генератора;
• generate_api_docs.ps1 - независимый резервный генератор на PowerShell.

Текущий снимок построен по frontend-сборке 2100d87c и содержит:

| HTTP-метод | Количество | |—|—:| | GET | 439 | | POST | 243 | | PUT | 86 | | PATCH | 29 | | DELETE | 48 | | Всего | 845 |

Готовые выпуски

В разделе Releases для каждой обнаруженной frontend-сборки публикуются:

• готовый Markdown-файл ReManga-API-<версия>.md;
• endpoints.json;
• endpoints.csv;
• snapshot-summary.json.

Название тега имеет вид frontend-<хеш>, например frontend-9596a55d. Старые выпуски сохраняются, поэтому документацию разных сборок можно сравнивать.

Готовый генератор публикуется отдельно с тегами generator-vX.Y.Z. Portable-архив для Windows x64 содержит GUI, CLI и собственную Java-среду, поэтому устанавливать Java отдельно не требуется.

Автоматическое обновление

GitHub Actions проверяет версию frontend ReManga каждые двенадцать часов.

Обычная проверка загружает только HTML-страницу каталога и сравнивает её хеш с уже опубликованными Releases. Workflow сначала обращается к основному домену, а затем пробует официальное зеркало реманга.орг.

Если обнаружена новая сборка, workflow автоматически:

1. скачивает зафиксированный выпуск Kotlin-генератора и проверяет SHA-256;
2. запускает консольный EXE;
3. проверяет полученный JSON;
4. коммитит обновлённую документацию в main;
5. создаёт новый GitHub Release;
6. прикладывает готовые Markdown, JSON и CSV.
7. формирует список добавленных, изменённых и удалённых API-методов;
8. отправляет сводку и списки в канал подробных обновлений Discord.

Состояние автоматической проверки видно на вкладке Actions → Обновление документации API.

Сообщество и подробные обновления

Подробные уведомления о новых версиях и изменениях API публикуются в Discord.

Связаться с автором напрямую можно в Telegram: @ps1xo_on1ks.

При каждой новой frontend-сборке в Discord публикуются версия, ссылка на Release и полные списки добавленных, изменённых и удалённых API-методов. Подробнее: уведомления о версиях.

Быстрый старт

Для просмотра документации откройте API_REFERENCE.md.

Для ручной генерации скачайте последний архив remanga-api-gen-<версия>-windows-x64.zip из Releases, распакуйте его и запустите:

• remanga_api_gen.exe - окно с выбором папки, прогрессом и журналом;
• remanga_api_gen_cli.exe - консольный запуск и автоматизация.

Пример CLI:

.\remanga_api_gen_cli.exe --page-url "https://remanga.org/card" --output "."

Резервный способ без Portable-архива:

powershell -NoProfile -ExecutionPolicy Bypass -File .\generate_api_docs.ps1

Сборка Kotlin-версии из исходников требует JDK 21, но не требует установленного Gradle:

cd .\generator
.\gradlew.bat clean test portableSha256 --no-daemon

Готовый ZIP и SHA-256 появятся в generator\build\distributions.

Генератор:

1. загружает страницу каталога ReManga;
2. определяет актуальную frontend-сборку;
3. читает публичные JavaScript-файлы;
4. извлекает HTTP-методы и пути;
5. формирует Markdown, JSON и CSV.

Он не выполняет POST, PUT, PATCH или DELETE-запросы, не входит в аккаунт и не требует токена.

Ограничения

Production-сборка позволяет достоверно извлечь HTTP-методы, пути, параметры пути и некоторые заголовки. Полные схемы query-параметров, тела и ответа в ней отсутствуют, поэтому они не выдумываются.

Поле bearer_capable означает только то, что клиент способен приложить Bearer-токен. Оно не доказывает обязательность авторизации для конкретного маршрута.

API не заявлено как публичное и стабильное. Маршруты могут измениться или исчезнуть без предупреждения.

Проекты, использующие API

Здесь публикуются завершённые инструменты и приложения, которые используют описанные маршруты ReManga API.

Пока список пуст. Загрузчик карточек будет добавлен после завершения и публикации стабильной версии.

Автор стороннего проекта может добавить его через Pull Request. Формат записи:

- [Название проекта](https://github.com/author/project) - краткое описание и поддерживаемые платформы.

Проект должен быть доступен для проверки, иметь понятную инструкцию по запуску и не собирать чужие пароли, cookies или токены. Подробные требования находятся в CONTRIBUTING.md.

Сторонние проекты

• vraestoren/remanga.py - неофициальная Python-обёртка;
• otaku-melons/remanga - неофициальный модуль парсера для Melon.

Они используются только как дополнительные ориентиры и не подтверждают официальный статус API.

Ответственное использование

• Не проверяйте изменяющие методы на реальных аккаунтах.
• Не собирайте пароли, cookies или токены пользователей.
• Используйте кэш и разумные интервалы между запросами.
• Соблюдайте условия ReManga, robots.txt и права владельцев контента.
• Для публичных и коммерческих интеграций получите разрешение ReManga.

Справочник описывает обнаруженные технические маршруты, но не предоставляет дополнительных прав на API или контент сайта.