Публичный API

Бесплатный read-only JSON API по данным Mineforgian. Без ключей и регистрации, CORS открыт для любых доменов, ответы кешируются на CDN. Пожалуйста, кешируйте ответы и на своей стороне — данные статичны и меняются только с обновлениями игры.

JSONCORS: *Без API-ключейv1

Формат ответа

{ "apiVersion": "v1", "data": … }   // успех
{ "apiVersion": "v1", "error": "…" } // ошибка (400/404)

GET/api/v1

Список всех доступных эндпоинтов.

curl https://mineforgian.pages.dev/api/v1

GET/api/v1/tools

Все инструменты сайта: slug, название, категория и ссылка.

curl https://mineforgian.pages.dev/api/v1/tools

GET/api/v1/pack-formats

Таблица pack_format ресурспаков и датапаков по версиям игры.

?version — фильтр по версии, например 1.21

curl "https://mineforgian.pages.dev/api/v1/pack-formats?version=1.21"

GET/api/v1/potions

Эффекты зелий; с параметром id — эффект вместе с пошаговым планом варки.

?id — id эффекта, например strength

curl "https://mineforgian.pages.dev/api/v1/potions?id=strength"

GET/api/v1/villager-trades

13 профессий со сделками по уровням и ценами в изумрудах.

?profession — id профессии, например librarian

curl "https://mineforgian.pages.dev/api/v1/villager-trades?profession=librarian"

GET/api/v1/banner-patterns

40 узоров (современный id + легаси-код) и 16 цветов красителей.

curl https://mineforgian.pages.dev/api/v1/banner-patterns

Версионирование: ломающие изменения выйдут только как /api/v2 — существующие URL не ломаются.