Плагин для серверов Майнкрафт, который связывает рынок GrzybcioRynek с публичным сайтом через HTTP API. Он отдаёт актуальные данные рынка только для чтения: лоты, категории, статистику, историю сделок, цены и профили продавцов.
Возможности
- REST API с лотами, категориями, статистикой, историей сделок и цен, профилями игроков и списком продавцов.
- Поток SSE с событиями создания, продажи, удаления и истечения лотов.
- Ограничение частоты запросов по IP-адресу и ключу API.
- Кэш ответов с настраиваемым временем хранения для лотов, статистики, игроков и истории.
- Документация API доступна по путям
/api/docsи/api/openapi.json.
Команды
/grzybciorynekweb status— показывает состояние моста, API, SSE и кэша./grzybciorynekweb reload— перечитывает конфиг и перезапускает HTTP-службу при изменении адреса привязки./grzybciorynekweb key— выводит названия настроенных ключей без их содержимого./grzybciorynekweb cache clear— очищает кэш API.
Альтернативная команда: /grynekweb.
Права
Для всех административных команд требуется право grybciorynekweb.admin.
Настройка
Ключи API задаются в api.authentication.keys; для сайта им можно выдать разрешения listings.read, categories.read, stats.read, history.read и players.read. Ключ передаётся в заголовке X-API-Key либо Authorization: Bearer; для SSE используется параметр ?api_key=… у /api/v1/events.
Для обращений к плагину напрямую из браузера укажите адрес сайта в api.cors.allowed-origins. Не оставляйте ключи CHANGE_ME и не открывайте HTTP-порт без аутентификации, файрвола или обратного прокси.
Требования
Нужны сервер Paper, Java, GrzybcioRynek, Vault и работающая экономика. Если GrzybcioRynek отключён или несовместим, мост не запустится.
