Dokumentacja API v5

Publiczne API dla aktywnych ofert, statusu runtime, pokrycia źródeł i przeglądania katalogu. Każda publiczna integracja musi zachować atrybucję Avion Tracker i link zwrotny do https://tracker.discordlabs.app.

Otwórz API v5 OpenAPI JSON Otwórz Meta Otwórz panel

Wymagana atrybucja 90 zapytań / minuta / IP Wersjonowana powierzchnia publiczna Zgodne z OpenAPI

Endpointy

Publiczne integracje powinny korzystać wyłącznie z API v5. Poniższe trasy obejmują status, zasięg źródeł, feedy i dostęp do katalogu dla stron, widgetów oraz botów.

GET /api/v5/meta

Informacje o wersji, linkach, limitach i podsumowaniu platformy.

GET /api/v5/status

Zdrowie runtime, status gatewaya, shardy, klastry i bieżący zasięg.

GET /api/v5/coverage

Rozbicie aktywnych feedów według źródeł i sklepów.

GET /api/v5/offers

Publiczny feed aktywnych ofert z filtrami: mode, sort, store, platform, kind, limit.

GET /api/v5/catalog

Wyszukiwanie i przeglądanie katalogu z parametrami q, source, limit i offset.

GET /api/v5/trending

Śledzone tytuły uporządkowane według zasięgu, darmowych dropów i pokrycia rynku.

GET /api/v5/latest

Najnowsze śledzone tytuły i świeży ruch w katalogu.

GET /api/v5/freenow

Skrócony feed bieżących darmowych ofert, sortowany po najbliższym końcu.

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

Feed na poziomie źródła dla dashboardów, widgetów i zewnętrznych mirrorów.

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

Feed na poziomie sklepu z kontrolą trybu i sortowania.

GET /api/v5/openapi.json

Kontrakt OpenAPI czytelny maszynowo do generowania klientów.

Zasady użycia

Możesz osadzać lub mirrorować dane API v5, ale integracja musi wyraźnie wskazywać Avion Tracker, zachować link źródłowy do https://tracker.discordlabs.app i nie usuwać nagłówków copyright. Zabezpieczenia techniczne ograniczają nadużycia, ale atrybucja prawna nadal ma znaczenie.

Copyright

Ochrona

API v5 udostępnia limitowanie per IP, nagłówki brandingowe, linki do kanonicznej dokumentacji oraz jawne metadane atrybucji w każdej odpowiedzi.

Przykłady

Skorzystaj z gotowych publicznych tras poniżej do widgetów, zadań cron, stron i dashboardów.

Publiczny free-now

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

Feed źródła

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

Stan źródeł

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

Notatka wdrożeniowa

Buforuj odpowiedzi tylko krótko, zachowuj nagłówki atrybucji i dodawaj link do https://tracker.discordlabs.app, gdy osadzasz dane albo publikujesz ich kopię.

Przykładowa odpowiedź

Każda odpowiedź opakowuje dane w stabilny envelope z wersją, timestampami i metadanymi atrybucji.

{
  "apiVersion": "v5",
  "resource": "offers",
  "generatedAt": 1777647957395,
  "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
      }
    ]
  }
}