Booster APIv2Beta

SimpleBoost API

REST API для автоматической покупки Discord бустов и Nitro gifts. Сейчас в бета-версии — эндпоинты и поведение могут меняться.

Base URLhttps://boostersimple.cfd/api/v2
AuthX-API-Key или Bearer
Ключ@simplebooster_bot → Профиль → API

📡 Общее

GET/health🌐 Public

Проверка работоспособности API.

Примеры кода

Ответы

POST/boost🔑 Auth

Покупка и автоматическая выдача бустов на Discord сервер.

📋 Параметры

urlstringDiscord invite URL или код
countnumberКоличество бустов · мин. 1, макс. = сток (GET /stock)
durationstring1m или 3m
1m
Бусты на 1 месяц
3m
Бусты на 3 месяца

Примеры кода

Ответы

🔄 Статусы заказа

pending
Заказ создан, выдача в процессе
completed
Все бусты успешно выданы
partial
Частичная выдача
failed
Выдача не удалась

📡 Эндпоинты

GET/server/check🔑 Auth

Проверка, готов ли Discord-инвайт/сервер к выдаче бустов (до создания заказа). Query: invite или url. Также POST /server/check с {"invite":"..."}.

Примеры кода

Ответы

GET/balance🔑 Auth

Баланс магазина в ₽ (как в профиле бота).

Примеры кода

Ответы

GET/order/{order_id}🔑 Auth

Информация о boost-заказе по ID (duration, url, requested/delivered, guild). Та же система заказов, что и у gifts.

Примеры кода

Ответы

GET/stock🌐 Public

Доступный сток бустов по периодам.

Примеры кода

Ответы

GET/prices🔑 Auth

Розничная цена за 1 буст из настроек бота (₽).

Примеры кода

Ответы

Общее с бустами — Тот же API-ключ (X-API-Key / Bearer), баланс и order id. Для покупки gifts нужен Idempotency-Key. Результат смотрите через GET /order/{orderId}.
POST/gifts/buy🔑 Auth

Покупка Discord Nitro gift-ссылок со склада (синхронная выдача). Требуется Idempotency-Key. В ответе urls[] (совместимость) и gifts[{url,expiresAt,activationSecondsLeft}] — секунды до конца срока активации ссылки (не длительность Nitro). Просмотр — GET /order/{orderId}.

📋 Параметры

skustringbasic_1m · basic_12m · full_1m · full_12m
quantitynumberКоличество ссылок · мин. 1, макс. 50 (и доступный сток)
Idempotency-KeyheaderОбязательный ключ повтора (8–128 безопасных ASCII-символов)
basic_*
Nitro Basic · 1м / 12м
full_*
Nitro Full · 1м / 12м

Примеры кода

Ответы

⏱️ Активация и длительность Nitro

Длительность SKU (1m/12m) — срок Nitro после активации. TTL ссылки задаётся при заливе (обычно 1–48 часов) и отдаётся как expiresAt / activationSecondsLeft при покупке и GET order.

🔄 Статусы заказа

pending
Заказ создан, выдача в процессе
completed
Gift-ссылки выданы (urls + gifts[])
partial
Частичная выдача
failed
Выдача не удалась

📡 Эндпоинты

GET/balance🔑 Auth

Баланс магазина в ₽ (как в профиле бота). Также для покупки gifts.

Примеры кода

Ответы

GET/order/{order_id}🔑 Auth

Информация о заказе по ID. Gift-заказы: product/sku, urls[] и gifts[{url,expiresAt,activationSecondsLeft}] (оставшееся время активации пересчитывается при каждом ответе).

Примеры кода

Ответы

GET/gifts/stock🌐 Public

Доступный сток Nitro gifts по SKU (basic_1m, basic_12m, full_1m, full_12m). Считается только sellable (available и срок активации expiresAt > now). Также soonestExpiresAt по SKU (ISO или null).

Примеры кода

Ответы

GET/gifts/catalog🌐 Public

Публичный каталог gifts: названия и длительности SKU (без пользовательских цен). Длительность SKU (1м/12м) — срок Nitro, не TTL активации ссылки (при заливе 1–48 часов).

Примеры кода

Ответы

GET/gifts/prices🔑 Auth

Розничные/оптовые цены за единицу по всем 4 gift SKU (с учётом роли).

Примеры кода

Ответы

POST/gifts/buy🔑 Auth

Покупка gift-ссылок. Body: {sku, quantity}. Header: Idempotency-Key. Тот же формат, что GET /order/{orderId}: urls[] и gifts[{url,expiresAt,activationSecondsLeft}].

Примеры кода

Ответы