Справочник API
Все эндпоинты с примерами для копирования и живым обозревателем.
Хранится только в памяти этой вкладки и никуда не записывается. Если вы уже вошли в /admin, поле можно оставить пустым — те же маршруты авторизует сессионная кука.
Публичные
Без аутентификации. Эти эндпоинты вызывают ваши загрузчики в Roblox.
Админ — скрипты
Отправляйте Authorization: Bearer <ADMIN_TOKEN>. Портал /admin использует для тех же маршрутов сессионную куку; подойдёт любой из двух способов.
Админ — ключ
Служебные эндпоинты для ротации ключа.
Коды ошибок
Ошибки возвращают { "ok": false, "error": "<code>" }, а при ошибках валидации — понятное человеку message.
| Код | Статус | Значение |
|---|---|---|
| unauthorized | 401 | Bearer-токен или админская кука отсутствуют либо неверны. |
| rate_limited | 429 | Слишком много запросов. Retry-After подскажет, сколько ждать. |
| bad_request | 400 | Тело запроса не было корректным JSON. |
| INVALID_SLUG | 400 | Slug не состоит из 3–64 строчных букв, цифр и дефисов. |
| INVALID_TITLE | 400 | Заголовок был пустым. |
| INVALID_IMAGE_URL | 400 | imageUrl не начинается с http:// или https://. |
| EMPTY_SOURCE | 400 | Исходник скрипта был пуст или состоял из пробелов. |
| SLUG_TAKEN | 400 | Этот slug уже занят другой записью. |
| NOT_FOUND | 404 | Записи с таким slug нет. |
| internal_error | 500 | Непредвиденный сбой сервера или базы данных. |