Twitch Drops API-referencia
Ingyenes JSON API minden aktív Twitch Drops- és jutalomkampányról, percenként frissítve, valamint a Twitch globális csevegőjelvényeiről. Hívhatod névtelenül, vagy ingyenes API-kulccsal a magasabb korlátért.
Próbáld ki
Útvonalak
Minden útvonal JSON-nal válaszol egy GET kérésre, és bármely oldal böngészője hívhatja az API-t (CORS). Sem a /drops, sem a /rewards, sem a /badges nem igényel regisztrációt; egy ingyenes API-kulcs mindegyiken megemeli a korlátot.
Mindhárom útvonal ugyanúgy válaszol: a lista, a legutóbbi Twitch-lekérés ideje (refreshedAt) és a kéréskorlátod (rateLimit).
Hitelesítés
A /drops, a /rewards és a /badges olvasásához nem kell sem fiók, sem kulcs. A névtelen hívásokat IP-címenként számoljuk: útvonalanként 5 percenként 1 kérés.
A kulcsok ingyenesek: jelentkezz be Discord-, Twitch- vagy GitHub-fiókkal, hozz létre egyet az irányítópulton, és küldd ebben a fejlécben: X-API-Key. A kulcs alapértelmezés szerint percenként 1 kérés szintre emeli a korlátodat, kérésre ennél is többre, és megmutatja a forgalmadat.
A kulcsot tartsd a szervereden: aki elolvassa, a te korlátodat használhatja el. Környezeti változóból olvasd be, ne írd bele a kódba.
Kérésfejléc
# Anonymouscurl https://drops.sunkwi.com/api/twitch/drops
# With an API key, showing the rate-limit headerscurl -i -H "x-api-key: $DROPS_API_KEY" https://drops.sunkwi.com/api/twitch/dropsSzerezz ingyenes API-kulcsot
A kulcs ingyenes. Útvonalanként 5 percenként 1 kérésről percenként 1 kérés szintre emeli a korlátodat, az irányítópultod pedig mutatja a forgalmát.
- Jelentkezz be Discord-, Twitch- vagy GitHub-fiókkal: jelszó és űrlap nélkül.
- Nyisd meg az API-kulcsok részt az irányítópultodon, és hozz létre egy kulcsot a botod vagy oldalad nevével.
- Másold ki a kulcsot, amikor megjelenik (csak egyszer), és a szerveredről küldd ebben a fejlécben:
X-API-Key.
Drops-kampányok lekérése
Minden aktív Drops-kampány játékonként csoportosítva: játékonként egy elem a games tömbben, a kampányai a rewards mezőben, a legutóbbi Twitch-ellenőrzés idejével és a kéréskorlátoddal együtt.
Választörzs
Game
DropCampaign-, TimeBasedDrop- és Benefit-mezők
DropCampaign
TimeBasedDrop
Benefit
A mezőnevek a Twitchtől származnak, és sosem változnak: új mezők megjelenhetnek, a meglévők maradnak.
Válaszkódok
curl https://drops.sunkwi.com/api/twitch/drops{ "games": [ { "gameId": "460630", "gameDisplayName": "Rainbow Six Siege", "gameBoxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/460630-120x160.jpg", "startAt": "2026-10-17T05:00:00Z", "endAt": "2026-11-02T13:59:59.999Z", "rewards": [ { "id": "ef80b803-…", "name": "R6S S2 2026 19", "startAt": "2026-10-17T05:00:00Z", "endAt": "2026-11-02T13:59:59.999Z", "firstSeenAt": "2026-10-17T05:00:41.208Z", "accountLinkURL": "https://drops-register.ubi.com", "timeBasedDrops": [ { "name": "Esports Pack", "requiredMinutesWatched": 120, "repeat": null, "benefitEdges": [{ "benefit": { "name": "Esports Pack", … } }] } ], … } ] }, … ], "refreshedAt": "2026-10-24T21:14:01.936Z", "rateLimit": { "limit": 1, "remaining": 0, "resetAt": "2026-10-24T21:15:12.000Z" }}Jutalomkampányok lekérése
Minden aktív jutalomkampány (az egész Twitchre kiterjedő események, csevegőjelvények, partnerjutalmak) a campaigns tömbben, a legutóbbi Twitch-ellenőrzés idejével és a kéréskorlátoddal együtt.
Választörzs
RewardCampaign
Jutalommezők
RewardGroup
Reward
Válaszkódok
curl https://drops.sunkwi.com/api/twitch/rewards{ "campaigns": [ { "id": "19f00aac-…", "name": "First Partners Collection", "brand": "Pokemon", "status": "ACTIVE", "startsAt": "2026-08-24T17:00:00Z", "endsAt": "2026-11-01T07:00:00Z", "firstSeenAt": null, "isSitewide": true, "unlockRequirements": { "minuteWatchedGoal": 20, "subsGoal": 0 }, "rewards": [{ "name": "Great Ball", "earnableUntil": "2026-11-01T07:00:00Z", … }] }, { "id": "b7669f9e-…", "name": "GTAVI Launch Celebration", "brand": "Rockstar Games", "status": "UPCOMING", "startsAt": "2026-11-18T11:00:00Z", "endsAt": "2026-12-01T07:59:59.999Z", "unlockRequirements": { "minuteWatchedGoal": 60, "subsGoal": 0 }, "rewardGroups": [ { "id": "6a0e…", "unlockRequirements": { "minuteWatchedGoal": 60, "subsGoal": 0 }, "repeat": { "everyHours": 24, "times": 6 }, "categories": [{ "id": "1867279146", "displayName": "Grand Theft Auto VI", "slug": "grand-theft-auto-vi" }], "rewards": [{ "name": "GTA DVD Chest", … }] }, … ], … }, … ], "refreshedAt": "2026-10-24T21:14:01.936Z", "rateLimit": { "limit": 1, "remaining": 0, "resetAt": "2026-10-24T21:15:12.000Z" }}Csevegőjelvények lekérése
A Twitch globális csevegőjelvényei a badges tömbben, változatonként egy elem, mindegyiknél a megszerzés módjával, ha az API ismeri (requirement), valamint a Twitch-jelvények legutóbbi lekérésének idejével és a kéréskorlátoddal.
Választörzs
Badge
BadgeRequirement-mezők
BadgeRequirement
Drops-gyűjtő programokhoz: tartsd meg azokat a jelvényeket, amelyeknél a requirement.watchTimeOnly értéke true. Ezek olyan Drops-kampányból származnak, amely pusztán nézési időért adja a jelvényt, soha nem feliratkozásért. A startAt és az endAt értékét is nézd meg: a véget ért kampány a listában marad.
Egyes jelvények többet kérnek: repeat esetén minden időszakban nézd meg újra a requiredMinutes időt, times alkalommal, endAt előtt; a categories bármely élő csatornája számít; collection esetén a láda más jelvényt is adhat, mint amit szeretnél (chestSize), a completeAll pedig az egész gyűjteményt kéri, a feliratkozásokkal együtt. evolvesFrom esetén nézés előtt vedd fel ezt a jelvényt.
Válaszkódok
curl https://drops.sunkwi.com/api/twitch/badgesKéréskorlátok
Minden útvonalnak saját számlálója van: a /drops hívása sosem fogyasztja a /rewards vagy a /badges keretét. A kampányok percenként egyszer, a jelvények 5 percenként változnak, így a gyakoribb lekérdezés semmi újat nem hoz.
Válaszfejlécek
Az elutasított hívás (429) is hívásnak számít: újrapróbálás előtt várd ki a Retry-After idejét.
HTTP/1.1 429 Too Many Requestscontent-type: application/json; charset=utf-8retry-after: 214ratelimit-limit: 1ratelimit-remaining: 0ratelimit-reset: 214ratelimit-policy: 1;w=300
{ "code": "RATE_LIMITED" }Hibák
A hibák stabil kódot tartalmazó JSON-törzzsel válaszolnak: { "code": "RATE_LIMITED" }. A kódok sosem változnak: a code mezőre építs, ne az üzenet szövegére.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Az oldaltól az API-ig
Az oldal minden lapja ugyanezeket az útvonalakat olvassa. Itt látod, hogy egy lap tartalma hol található a válaszokban.
A játékoldal címe a játék nevéből készül (Rocket League → /drops/rocket-league). Ez az oldal saját címe, nem az API egy mezője: a játékokat a gameId alapján párosítsd.