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_time1 — за всё время

Ответ

{
  "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_only1 — только новые пользователи
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_typeID кейса (см. список ниже), по умолчанию любой
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
providerall | stars | ton, по умолчанию all
https://api.giftsdrop.space/v1/deposit?telegram_id=123456789&min_stars=100

GET /v1/task

Выполнил задание

Выполнил задание внутри GiftsDrop. Одноразовые задания засчитываются независимо от окна, ежедневные — если последний раз выполнены в окне. Без task_id считается любое задание.

task_idID задания (см. список ниже)
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 — кейс за рекламу.