GiftsDrop Partner API
Проверка заданий для партнёров: бесплатный кейс, кейс за рекламу, депозит, вход в приложение и другие действия пользователя в @giftdroptg_bot.
Как пользоваться
Все запросы — GET на https://api.giftsdrop.space/v1/<проверка>. API-ключ не нужен. CORS открыт. Лимит — 120 запросов в минуту с одного IP.
По умолчанию действие ищется за текущие сутки по UTC (с 00:00 UTC). Окно меняется параметрами:
telegram_id | обязательный — Telegram ID пользователя (алиас user_id) |
hours | скользящее окно: последние N часов |
since | начало окна: ISO-дата или unix-время (сек/мс) |
all_time | 1 — за всё время |
Ответ
{
"ok": true,
"check": "free-case",
"telegram_id": 123456789,
"registered": true, // пользователь есть в GiftsDrop
"completed": true, // задание выполнено
"success": true, // то же, что completed
"count": 1, // сколько раз действие выполнено за окно
"last_at": "2026-09-25T10:12:00.000Z",
"since": "2026-09-25T00:00:00.000Z",
"checked_at": "2026-09-25T10:15:03.000Z"
}
Ошибки: 400 — неверные параметры, 404 — неизвестная проверка, 429 — превышен лимит, 500 — ошибка сервера. Тело: {"ok": false, "error": "..."}.
Проверки
GET /v1/app-open
Зашёл в приложение
Пользователь открывал Mini App в указанном окне. С new_only=1 засчитываются только новые пользователи, зарегистрированные в этом окне.
new_only | 1 — только новые пользователи |
https://api.giftsdrop.space/v1/app-open?telegram_id=123456789&new_only=1&hours=24
GET /v1/free-case
Открыл бесплатный кейс
Открыл ежедневный бесплатный кейс (1star).
min_count | сколько раз, по умолчанию 1 |
https://api.giftsdrop.space/v1/free-case?telegram_id=123456789
GET /v1/ads-case
Открыл кейс за рекламу
Посмотрел рекламу и открыл кейс за рекламу (ads).
min_count | сколько раз, по умолчанию 1 |
https://api.giftsdrop.space/v1/ads-case?telegram_id=123456789
GET /v1/case
Открыл любой кейс
Открыл любой кейс или кейс конкретного типа.
case_type | ID кейса (см. список ниже), по умолчанию любой |
min_count | сколько кейсов, по умолчанию 1 |
https://api.giftsdrop.space/v1/case?telegram_id=123456789&case_type=easynft&min_count=3
GET /v1/deposit
Сделал депозит
Сумма оплаченных пополнений в звёздах за окно (TON пересчитывается в звёзды) ≥ min_stars. Бонусы от промокодов не считаются.
min_stars | минимальная сумма в звёздах, по умолчанию 1 |
provider | all | stars | ton, по умолчанию all |
https://api.giftsdrop.space/v1/deposit?telegram_id=123456789&min_stars=100
GET /v1/task
Выполнил задание
Выполнил задание внутри GiftsDrop. Одноразовые задания засчитываются независимо от окна, ежедневные — если последний раз выполнены в окне. Без task_id считается любое задание.
task_id | ID задания (см. список ниже) |
min_count | сколько разных заданий, по умолчанию 1 |
https://api.giftsdrop.space/v1/task?telegram_id=123456789&task_id=task_sub_giftdropchannel&all_time=1
GET /v1/pvp
Сыграл в PvP
Вошёл в PvP-комнату.
min_count | сколько игр, по умолчанию 1 |
https://api.giftsdrop.space/v1/pvp?telegram_id=123456789
GET /v1/crash
Сыграл в Crash
Сделал ставку в Crash.
min_count | сколько ставок, по умолчанию 1 |
https://api.giftsdrop.space/v1/crash?telegram_id=123456789
GET /v1/upgrade
Сделал апгрейд
Попробовал апгрейд предмета (успешный или нет).
min_count | сколько апгрейдов, по умолчанию 1 |
https://api.giftsdrop.space/v1/upgrade?telegram_id=123456789
GET /v1/referrals
Пригласил друзей
Количество приглашённых рефералов за окно.
min_count | сколько друзей, по умолчанию 1 |
https://api.giftsdrop.space/v1/referrals?telegram_id=123456789&min_count=3&all_time=1
ID заданий
| task_id | Задание | Тип |
|---|---|---|
task_profile_bio | Добавь свою ссылку GiftsDrop в описание профиля | одноразовое |
task_sub_giftdropchannel | Подпишись на @giftdropchannel | одноразовое |
task_sub_giftdropchat | Вступи в чат GiftsDrop | одноразовое |
task_sub_wwstarss | Подпишись на @wwstarss | одноразовое |
task_sub_pixlws | Подпишись на @pixlws | одноразовое |
task_sub_vse_o_kripte | Подпишись на «Все о крипте» | одноразовое |
task_play_pxlw | Зайти в игру Pixel World | одноразовое |
task_open_antarctic_wallet | Открыть Antarctic Wallet | одноразовое |
task_open_stratapp | Заработать GRAM бесплатно | одноразовое |
task_open_gramminer | Заработать GRAM бесплатно | одноразовое |
task_open_gramgarden | Заработать GRAM бесплатно | одноразовое |
task_open_portals | Открыть Portals | одноразовое |
task_open_mrkt | Открыть MRKT | одноразовое |
task_open_giftsniper | Открыть GiftSniper | одноразовое |
task_open_gift_satellite | Открыть Gift Satellite | одноразовое |
task_open_stonksgift | Открыть бота | одноразовое |
task_watch_ad | Посмотреть рекламу | ежедневное |
task_share_story | Выложить историю | ежедневное |
task_share_friends | Отправить приглашение 5 друзьям или чатам | ежедневное |
task_deposit_100 | Пополнить баланс на 100⭐ за день | ежедневное |
task_create_giveaway | Создать розыгрыш | ежедневное |
task_play_pvp | Сыграть в PvP | ежедневное |
ID кейсов
1star ads ref1 dep2 dep1 easynft newyear santaclaus shcolnik solnechniy bomj allin rabotyaga osenni dozhd okup pobedniy bogati millioner stars premium premium3
1star — бесплатный кейс, ads — кейс за рекламу.