Документация API v5

Публичный API для текущих предложений, статуса выполнения, охвата источников и просмотра агрегированного каталога. Все общедоступные интеграции должны сохранять атрибуцию Avion Tracker и ссылаться на https://tracker.discordlabs.app.

Открытый API v5 OpenAPI JSON Открытая мета Открыть панель управления

Требуется указание авторства 90 запрос/минута/IP Версионная общедоступная поверхность OpenAPI-ready

Конечные точки

Public integrations should target v5 only. The routes below cover status, coverage, feeds and catalog access for websites, widgets and bots.

GET /api/v5/meta

Информация о версии, ссылки, ограничения и сводка платформы.

GET /api/v5/status

Состояние выполнения, состояние шлюза, сегменты, кластеры и прямая трансляция.

GET /api/v5/coverage

Разбивка активных фидов по источникам и магазинам.

GET /api/v5/offers

Публичная прямая трансляция предложений с фильтрами: режим, сортировка, магазин, платформа, вид, лимит.

GET /api/v5/catalog

Поиск и просмотр каталога с параметрами q, источник, предел и смещение.

GET /api/v5/trending

Отслеживаемые игры ранжируются по спреду в реальном времени, бесплатным выпаданиям и охвату рынка.

GET /api/v5/latest

Самые последние треки и свежие обновления каталога.

GET /api/v5/freenow

Ярлык для бесплатных предложений, отсортированных по ближайшему сроку действия.

GET /api/v5/feeds/source/:sourceKey

Прямая трансляция каждого источника для информационных панелей, виджетов и внешних зеркал.

GET /api/v5/feeds/store/:storeKey

Прямая трансляция для каждого магазина с элементами управления режимом и сортировкой.

GET /api/v5/openapi.json

Машиночитаемый контракт OpenAPI для генерации клиентов.

Политика использования

Вы можете встроить или отразить данные API v5, но ваша интеграция должна явно указывать ссылку на Avion Tracker, сохранять ссылку на источник обратно на https://tracker.discordlabs.app и сохранять нетронутыми заголовки авторских прав. Технический контроль снижает злоупотребления, но юридическое установление авторства по-прежнему имеет значение.

Авторское право

Защита

API v5 ships with per-IP rate limiting, branding headers, canonical docs links and explicit attribution metadata in every response.

Примеры

Use the ready-made public routes below for widgets, cron pulls, websites and dashboards.

Публичное бесплатное сейчас

curl https://tracker.discordlabs.app/api/v5/freenow?limit=12

Исходный фид

https://tracker.discordlabs.app/api/v5/feeds/source/epic?mode=free&limit=20

Coverage snapshot

curl https://tracker.discordlabs.app/api/v5/coverage

Примечание по развертыванию

Cache responses briefly, preserve attribution headers, and link back to https://tracker.discordlabs.app whenever you embed or mirror the data.

Пример ответа

Каждый ответ упаковывает данные в стабильный конверт с версией, метками времени и метаданными атрибуции.

{
  "apiVersion": "v5",
  "resource": "offers",
  "generatedAt": 1777648052203,
  "attribution": {
    "brand": "Avion Tracker",
    "website": "https://tracker.discordlabs.app",
    "docs": "https://tracker.discordlabs.app/docs/api-v5",
    "dashboard": "https://tracker.discordlabs.app/dashboard",
    "copyright": "Copyright 2026 Avion Tracker. Public mirrors, embeds and dashboards must attribute Avion Tracker and link back to https://tracker.discordlabs.app.",
    "attributionRequired": true
  },
  "data": {
    "total": 2,
    "filtered": 2,
    "mode": "free",
    "sort": "ending",
    "store": null,
    "platform": null,
    "kind": "all",
    "offers": [
      {
        "key": "indiegala:https://www.indiegala.com/giveaways/card/grav-blazer-squared/1196402",
        "externalId": "https://www.indiegala.com/giveaways/card/grav-blazer-squared/1196402",
        "sourceKey": "indiegala-direct",
        "title": "Grav Blazer Squared",
        "description": "Enter the IndieGala giveaway for a chance to win a free key.",
        "url": "https://www.indiegala.com/giveaways/card/grav-blazer-squared/1196402",
        "imageUrl": "https://steamcdn-a.akamaihd.net/steam/apps/703530/header.jpg",
        "store": "indiegala",
        "type": "other",
        "kind": "game",
        "currency": "USD",
        "originalPrice": null,
        "discountedPrice": 0,
        "startsAt": null,
        "endsAt": 1777648382607,
        "platforms": [
          "windows"
        ],
        "rating": null,
        "discountPercent": null,
        "isFree": true
      },
      {
        "key": "indiegala:https://www.indiegala.com/giveaways/card/the-universim/1196261",
        "externalId": "https://www.indiegala.com/giveaways/card/the-universim/1196261",
        "sourceKey": "indiegala-direct",
        "title": "The Universim",
        "description": "Enter the IndieGala giveaway for a chance to win a free key.",
        "url": "https://www.indiegala.com/giveaways/card/the-universim/1196261",
        "imageUrl": "https://steamcdn-a.akamaihd.net/steam/apps/352720/header.jpg",
        "store": "indiegala",
        "type": "other",
        "kind": "game",
        "currency": "USD",
        "originalPrice": null,
        "discountedPrice": 0,
        "startsAt": null,
        "endsAt": 1777649042607,
        "platforms": [
          "windows"
        ],
        "rating": null,
        "discountPercent": null,
        "isFree": true
      }
    ]
  }
}