Бесплатный API и виджет кодов Roblox для вашего сайта
Показывайте актуальные коды Roblox на своём сайте с помощью одного фрагмента HTML или получайте их в JSON по личному ключу. Мы регулярно проверяем каждую игру, убираем истёкшие коды и помечаем новые как проверяемые, пока их не подтвердит второй источник. Бесплатно, на 14 языках.
Виджет: получите фрагмент · API кодов Roblox (JSON) с личным ключом
Виджет: получите фрагмент
Игру с таким названием мы пока не отслеживаем. Выберите игру из списка.
Вставьте его туда, где должен быть список: в запись, боковую панель или HTML-блок. Скрипт подключайте один раз на страницу, даже если списков несколько.
Предпросмотр
Единственное условие: оставить ссылку
- Во фрагменте есть ссылка на страницу кодов игры на BloxArchive. Оставьте её во фрагменте и на виду. Больше мы ничего не просим.
- Текст ссылки можно заменить на название игры или BloxArchive, а саму ссылку направить на любую страницу BloxArchive. Страница игры полезнее всего для ваших читателей.
- Если ссылку удалить или скрыть, виджет вместо списка покажет короткую заметку со ссылкой на коды.
- Коды с пометкой о проверке ещё не подтверждены. Пожалуйста, не выдавайте их за подтверждённые.
Как работает виджет
- Скрипт небольшой, загружается с
asyncи рисует список в собственном Shadow DOM, поэтому ваши стили и наши не мешают друг другу. - При каждом просмотре страницы читается актуальный список; браузер посетителя хранит его одну минуту.
- Сначала идут подтверждённые коды, затем новые коды на проверке. Коды, которые могли истечь, не показываются.
- Награды переводятся на выбранный язык. Игра, которую мы объединили или переименовали, продолжает работать по старому адресу.
- Мы видим, какие сайты загружают виджет и для какой игры, и время от времени читаем эти страницы, чтобы увидеть ссылку. Мы не ставим cookie и ничего не читаем о ваших посетителях.
- Тема «Авто» следует светлой или тёмной настройке посетителя. Чтобы виджет подходил к вашему дизайну, выберите выше тему, цвет, шрифт, углы и ширину или задайте CSS-переменные для блока в своей таблице стилей:
[data-bloxarchive] { --ba-accent: #e11d48; --ba-radius: 4px; }. Доступны:--ba-bg,--ba-ink,--ba-muted,--ba-line,--ba-soft,--ba-accent,--ba-accent-ink,--ba-radius,--ba-max-width. Старые сниппеты выглядят как прежде.
API кодов Roblox (JSON) с личным ключом
Хотите показывать коды в своём дизайне? Получите личный ключ для JSON API. Условие то же: страница с нашими кодами ссылается на bloxarchive.com. Сначала добавьте ссылку, опубликуйте страницу, затем введите здесь её адрес. Мы прочитаем страницу и сразу выдадим ключ, если ссылка на месте.
Скопируйте его сейчас: мы храним только его отпечаток и не сможем показать его снова.
Запросы
Передавайте ключ в заголовке X-API-Key (или как ?key=). Ответы в JSON; добавьте locale для одного из 14 языков.
GET https://bloxarchive.com/api/partner/v1/games?locale=ru&limit=100&offset=0
GET https://bloxarchive.com/api/partner/v1/games/blox-fruits-codes?locale=ru
X-API-Key: ba_.../games: все игры, которые мы публикуем, сначала игры с кодами, со slug, названием, числом игроков и количеством подтверждённых и ожидающих кодов./games/{slug}: одна игра.codes.activeподтверждены,codes.pendingновые и на проверке,codes.expiredперестали работать. Награды приходят на запрошенном языке.- В каждом ответе есть объект
attributionсо ссылкой, которую нужно поставить рядом с кодами, в готовом HTML. - Ключ принадлежит одному сайту. Запросы из браузера на другом сайте отклоняются. Ключ может делать 20 000 запросов в день; храните ответы у себя несколько минут.
Если ссылка пропадёт
Мы читаем вашу страницу каждый день. Если в её HTML нет ссылки на bloxarchive.com, каждый ответ API содержит notice с датой остановки ключа. Через 7 дней без ссылки ключ перестаёт работать. Он сам включится снова в течение недели после возвращения ссылки.
Вопросы
API кодов Roblox бесплатный?
Да. Виджет и JSON API бесплатны. Единственное условие: видимая ссылка на BloxArchive на странице, где показаны коды.
Как часто обновляются коды?
Каждая игра регулярно проверяется. Код считается рабочим, когда его подтверждает разработчик или два независимых источника, а истёкшие коды убираются из списка.
Какие игры и языки доступны?
Все игры, опубликованные на BloxArchive, на 14 языках и с переведёнными наградами.
Нужна ли учётная запись?
Нет. Для виджета регистрация не нужна. Для API укажите страницу со ссылкой на нас, и ключ будет выдан сразу.