Twitch Drops API žinynas
Nemokama JSON API su visomis aktyviomis Twitch Drops ir apdovanojimų kampanijomis, atnaujinamomis kas minutę, ir Twitch visuotiniais pokalbių ženkleliais. Kreipkitės anonimiškai arba su nemokamu API raktu, kad gautumėte didesnį limitą.
Išbandykite
Maršrutai
Kiekvienas maršrutas į GET užklausą atsako JSON formatu, o bet kurios svetainės naršyklės gali kreiptis į API (CORS). Nei /drops, nei /rewards, nei /badges nereikia registruotis; nemokamas API raktas kiekviename iš jų pakelia ribą.
Visi trys maršrutai atsako vienodai: sąrašas, paskutinio duomenų gavimo iš Twitch laikas (refreshedAt) ir jūsų užklausų limitas (rateLimit).
Autentifikavimas
/drops, /rewards ir /badges skaitymui nereikia nei paskyros, nei rakto. Anoniminiai iškvietimai skaičiuojami pagal IP adresą: 1 užklausa kas 5 min. kiekvienam maršrutui.
Raktai nemokami: prisijunkite su Discord, Twitch ar GitHub, sukurkite raktą valdymo skydelyje ir siųskite jį antraštėje X-API-Key. Pagal numatytuosius nustatymus raktas padidina jūsų limitą iki 1 užklausa per minutę (paprašius – daugiau) ir rodo jūsų srautą.
Laikykite raktą savo serveryje: bet kas, kas jį perskaitys, galės naudoti jūsų limitą. Skaitykite jį iš aplinkos kintamojo, o ne rašykite kode.
Užklausos antraštė
# 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/dropsGaukite nemokamą API raktą
Raktas nemokamas. Jis padidina jūsų limitą nuo 1 užklausos kas 5 min. iki 1 užklausa per minutę kiekvienam maršrutui, o valdymo skydelyje matysite jo srautą.
- Prisijunkite su Discord, Twitch ar GitHub: be slaptažodžio, be formų.
- Valdymo skydelyje atidarykite API raktai ir sukurkite raktą savo boto ar svetainės pavadinimu.
- Nukopijuokite raktą, kai jis bus parodytas (tik vieną kartą), ir siųskite jį antraštėje
X-API-Keyiš savo serverio.
Gauti Drops kampanijas
Visos aktyvios Drops kampanijos, sugrupuotos pagal žaidimą: vienas games elementas kiekvienam žaidimui, jo kampanijos – rewards, kartu su paskutinio Twitch nuskaitymo laiku ir jūsų užklausų limitu.
Atsakymo turinys
Game
DropCampaign, TimeBasedDrop ir Benefit laukai
DropCampaign
TimeBasedDrop
Benefit
Laukų pavadinimai gaunami iš Twitch ir niekada nesikeičia: gali atsirasti naujų laukų, esami išlieka.
Atsakymo kodai
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" }}Gauti apdovanojimų kampanijas
Visos aktyvios apdovanojimų kampanijos (renginiai visoje Twitch platformoje, pokalbių ženkleliai, partnerių apdovanojimai) masyve campaigns, kartu su paskutinio Twitch nuskaitymo laiku ir jūsų užklausų limitu.
Atsakymo turinys
RewardCampaign
Apdovanojimų laukai
RewardGroup
Reward
Atsakymo kodai
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" }}Gauti pokalbių ženklelius
Twitch visuotiniai pokalbių ženkleliai masyve badges, po vieną elementą kiekvienai versijai, kiekvienas su gavimo būdu, kai jį žino ši API (requirement), kartu su paskutinio Twitch ženklelių nuskaitymo laiku ir jūsų užklausų limitu.
Atsakymo turinys
Badge
BadgeRequirement laukai
BadgeRequirement
Drops mineriams: pasilikite ženklelius, kurių requirement.watchTimeOnly yra true. Juos duoda Drops kampanija tik už žiūrėjimo laiką, niekada už prenumeratą. Taip pat tikrinkite startAt ir endAt: pasibaigusi kampanija lieka sąraše.
Kai kurie ženkleliai reikalauja daugiau: su repeat žiūrėkite requiredMinutes vėl kiekvieną laikotarpį, times kartų, iki endAt; įskaitomas bet kuris categories tiesioginis kanalas; su collection skrynia gali duoti kitą ženklelį, nei norite (chestSize), o completeAll reikalauja visos kolekcijos, įskaitant prenumeratas. Su evolvesFrom prieš žiūrėdami pasirinkite tą ženklelį.
Atsakymo kodai
curl https://drops.sunkwi.com/api/twitch/badgesUžklausų limitai
Kiekvienas maršrutas turi savo skaitiklį: /drops iškvietimai niekada nenaudoja /rewards ar /badges limito. Kampanijos keičiasi kartą per minutę, o ženkleliai – kas 5 minutes, tad dažnesnės užklausos nieko naujo neduoda.
Atsakymo antraštės
Atmestas iškvietimas (429) irgi įskaitomas: prieš bandydami vėl, palaukite Retry-After.
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" }Klaidos
Klaidos grąžina JSON turinį su pastoviu kodu: { "code": "RATE_LIMITED" }. Kodai niekada nesikeičia: remkitės code, o ne pranešimo tekstu.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Nuo svetainės iki API
Kiekvienas šios svetainės puslapis skaito tuos pačius maršrutus. Štai kur atsakymuose yra tai, ką rodo puslapis.
Žaidimo puslapio adresas sudaromas iš žaidimo pavadinimo (Rocket League → /drops/rocket-league). Tai šios svetainės adresas, o ne API laukas: žaidimus atpažinkite pagal gameId.