gifts api

База: https://gifts.dev-angel-7553.dev/gifts/

Получить токен: @dev_angel_7553

Доступ

Каждый запрос к /gifts/* требует токен. Токен можно передать тремя способами — выбирайте любой:

# 1. query-параметр
curl "https://gifts.dev-angel-7553.dev/gifts/id-to-name.json?token=agk_xxxxxxxx"

# 2. заголовок
curl -H "X-Api-Token: agk_xxxxxxxx" https://gifts.dev-angel-7553.dev/gifts/id-to-name.json

# 3. Bearer
curl -H "Authorization: Bearer agk_xxxxxxxx" https://gifts.dev-angel-7553.dev/gifts/id-to-name.json

Токен привязывается к первому IP, с которого им воспользовались. Запрос с другого адреса вернёт 403.

Запросы

GET /gifts/id-to-name.json Все подарки каталога: id → название.

{
  "ok": true,
  "service": "dev-angel-7553-gifts",
  "count": 128,
  "gifts": { "5170233102089322756": "Plush Pepe", "...": "..." }
}

GET /gifts/backdrops.json Фоны: цвета в HEX, редкость в промилле.

{
  "ok": true,
  "service": "dev-angel-7553-gifts",
  "count": 34,
  "backdrops": [
    {
      "name": "Black",
      "backdropId": 12,
      "rarityPermille": 5,
      "colors": { "center": "#1b1b1f", "edge": "#000000",
                  "pattern": "#2a2a30", "text": "#ffffff" }
    }
  ]
}

GET /gifts/patterns.json Паттерны и подарки, в которых они встречаются.

{
  "ok": true,
  "service": "dev-angel-7553-gifts",
  "count": 50,
  "patterns": [ { "name": "Stars", "gifts": ["Plush Pepe", "Diamond Ring"] } ]
}

GET /gifts/patterns-custom-emoji.json Паттерн «Подарок/Паттерн» → id кастом-эмодзи.

{
  "ok": true,
  "service": "dev-angel-7553-gifts",
  "count": 1240,
  "items": [ { "pattern": "Plush Pepe/Stars", "customEmojiId": "5199664352600297564" } ]
}

GET /gifts/models/ · /gifts/patterns/ Список подарков, у которых есть модели / паттерны.

{
  "ok": true,
  "service": "dev-angel-7553-gifts",
  "path": "/gifts/models/",
  "count": 123,
  "entries": [ { "name": "Plush Pepe", "kind": "dir", "bytes": 0 } ]
}

GET /gifts/models/<Подарок>/models.json Модели конкретного подарка (для паттернов — /patterns/<Подарок>/patterns.json).

{
  "ok": true,
  "service": "dev-angel-7553-gifts",
  "gift": "Plush Pepe",
  "kind": "models",
  "count": 18,
  "items": [
    { "name": "Classic", "file": "Classic.tgs",
      "rarityPermille": 15, "documentId": "5431...9024" }
  ]
}

GET /gifts/models/<Подарок>/sorted.json Те же модели, только имена, отсортированные по редкости.

{ "ok": true, "service": "dev-angel-7553-gifts", "gift": "Plush Pepe",
  "kind": "models", "order": ["Classic", "Neon", "Gold"] }

GET /gifts/models/<Подарок>/<Модель>.tgs Сам стикер модели. Отдаётся как application/x-tgsticker (gzip-lottie).

curl -o Classic.tgs \
  "https://gifts.dev-angel-7553.dev/gifts/models/Plush%20Pepe/Classic.tgs?token=agk_xxxxxxxx"

GET /gifts/originals/<GiftId>/Original.tgs Оригинальный стикер подарка по его числовому id.

curl -o Original.tgs \
  "https://gifts.dev-angel-7553.dev/gifts/originals/5170233102089322756/Original.tgs?token=agk_xxxxxxxx"

Любую директорию можно просто открыть в браузере — вернётся список. С заголовком Accept: application/json тот же список приходит в JSON.