Нужен ли ключ API?

Нет. Для чтения не нужно вообще ничего. Для создания лога — тоже. Токен нужен только чтобы удалить лог или посмотреть его статистику просмотров, и выдаётся он при создании.

Что происходит с личными данными игрока?

Каждый лог чистится до сохранения: IP-адреса, адреса почты, имя учётной записи из путей к файлам, токены входа Minecraft, API-ключи и пароли. В ответе перечислено, что именно убрано. Локальные адреса и публичные DNS-серверы намеренно остаются: спрятать их значило бы потерять полезную для диагностики информацию и никого при этом не защитить.

Сколько живут логи?

Девяносто дней с последнего открытия страницы, а не с момента создания. Ссылка, которой пользуются, продолжает работать; та, которую никто не открывает, убирается сама. Чтение через API намеренно не продлевает срок — иначе любой монитор держал бы логи вечно.

Можно ли использовать в платном продукте?

Да. Встраивайте в свою панель хостинга или платный лаунчер. Просим только не выдавать наш анализ за свою работу и соблюдать лимиты запросов.

А если лог больше лимита?

Он будет обрезан, а не отклонён — у человека с гигантским логом обычно и проблема самая тяжёлая. В ответе будет сказано, что обрезка произошла, и вы сможете его предупредить.

Можно ли обращаться к API прямо из браузера?

Да. Публичные методы отвечают с открытой политикой CORS, поэтому веб-страница с любого домена может обращаться к ним без собственного прокси. Заголовки лимитов тоже открыты для JavaScript, так что клиент в браузере может притормозить до того, как его отклонят.

AlaCraft API

Бесплатная проверка логов Minecraft для вашей панели, бота или скрипта. Без ключа и регистрации.

Всё, что проверка логов делает через браузер, ваша программа может сделать по HTTP: отправить краш-репорт или лог сервера и получить обратно причину поломки и ссылку, которой можно поделиться. Для чтения не нужны ни ключ, ни аккаунт. Ниже — все методы с готовыми примерами на пяти языках, консоль, чтобы попробовать их не уходя со страницы, и понятный список того, что означает каждый код ошибки.

Первый запрос

Это работает прямо сейчас — скопируйте в терминал. Команда читает настоящий лог, который лежит здесь постоянно как пример.

curl https://alacraft.day/api/v1/logs/AlaDemo1

Методы

POST /api/v1/logs — Store a log and get a shareable URL
POST /api/v1/logs/preview — Analyse without storing
GET /api/v1/logs/{id} — Metadata and findings for a stored log
DELETE /api/v1/logs/{id} — Delete a log
GET /api/v1/logs/{id}/raw — The redacted log body as plain text
GET /api/v1/logs/{id}/insights — Findings only, as JSON or as a Markdown report
GET /api/v1/logs/{id}/parsed — The log as structured entries
GET /api/v1/logs/{id}/stats — Who opened this log (creator only)
POST /api/v1/logs/bulk-delete — Delete up to 256 logs in one call
GET /api/v1/logs/openapi.json — This document
GET /api/v1/logs/docs.md — The whole contract as one markdown file
GET /api/v1/logs/limits — Current size and retention limits
GET /api/v1/logs/filters — What is stripped before storage

Машиночитаемый контракт · Вся документация одним файлом