Siirry sisältöön
Twitch Drops API

Twitch Drops API -viiteopas

Ilmainen JSON-API, joka listaa jokaisen aktiivisen Twitch Drops -kampanjan ja palkintokampanjan ja päivittyy minuutin välein, sekä Twitchin yleiset chattimerkit. Kutsu sitä anonyymisti tai ilmaisella API-avaimella, jolloin raja on korkeampi.

Perus-URLhttps://drops.sunkwi.com/api/twitch
Hanki ilmainen API-avainLue viiteopas

Kokeile

Anonyymisti: 1 pyyntö 5 minuutin välein reittiä kohden. Avaimella: 1 pyyntöä minuutissa.

GET
Ladataan esikatselua…
Selaa

Reitit

Jokainen reitti vastaa GET-pyyntöön JSON-muodossa, ja minkä tahansa sivuston selaimet voivat lähettää pyyntöjä API:lle (CORS). Reitit /drops, /rewards ja /badges eivät vaadi rekisteröitymistä; ilmainen API-avain nostaa rajaa kullakin niistä.

Kaikki kolme reittiä vastaavat samalla tavalla: luettelo, viimeisimmän Twitch-haun ajankohta (refreshedAt) ja pyyntörajasi (rateLimit).

ReittiKuvaus
GET /dropsDrops-kampanjat peleittäin. Jokainen aktiivinen Drops-kampanja peleittäin ryhmiteltynä kentässä games: yksi kohde peliä kohden ja sen kampanjat kentässä rewards.
GET /rewardsPalkintokampanjat. Jokainen aktiivinen palkintokampanja (koko Twitchin tapahtumat, chattimerkit, kumppanipalkinnot) kentässä campaigns.
GET /badgesYleiset chattimerkit. Twitchin yleiset chattimerkit, yksi kohde versiota kohden kentässä badges, ja tieto niiden saamisesta, kun se tiedetään.

Todennus

Reittien /drops, /rewards ja /badges lukemiseen ei tarvita tiliä eikä avainta. Anonyymit kutsut lasketaan IP-osoitteittain: 1 pyyntö 5 minuutin välein kullakin reitillä.

Avaimet ovat ilmaisia: kirjaudu Discordilla, Twitchillä tai GitHubilla, luo avain hallintapaneelissa ja lähetä se otsakkeessa X-API-Key. Avain nostaa rajasi oletuksena 1 pyyntö pyyntöön minuutissa, pyynnöstä enemmän, ja näyttää liikenteesi.

Pyynnön otsake

OtsakeArvoKuvaus
X-API-Keyjdk_…API-avaimesi: valinnainen jokaisella reitillä. Tuntematonta, mitätöityä tai käytöstä poistettua avainta ei koskaan hylätä: kutsu lasketaan anonyymiksi, ja x-api-key-status: invalid kertoo sen.
Esimerkkipyyntö · curl
# 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/drops

Hanki ilmainen API-avain

Avain on ilmainen. Se nostaa rajasi 1 pyynnöstä 5 minuutin välein 1 pyyntö pyyntöön minuutissa jokaisella reitillä, ja hallintapaneelisi näyttää sen liikenteen.

  1. Kirjaudu Discordilla, Twitchillä tai GitHubilla: ei salasanaa, ei lomaketta.
  2. Avaa hallintapaneelista API-avaimet ja luo avain, jonka nimeät bottisi tai sivustosi mukaan.
  3. Kopioi avain, kun se näytetään (vain kerran), ja lähetä se palvelimeltasi otsakkeessa X-API-Key.

Hae Drops-kampanjat

GEThttps://drops.sunkwi.com/api/twitch/drops

Jokainen aktiivinen Drops-kampanja peleittäin ryhmiteltynä: yksi games-kohde peliä kohden ja sen kampanjat kentässä rewards, mukana viimeisimmän Twitch-tarkistuksen ajankohta ja pyyntörajasi.

Vastauksen runko

KenttäTyyppiKuvaus
gamesGame[]Aktiiviset kampanjat viimeisimmän tarkistuksen järjestyksessä. Tyhjä taulukko on kelvollinen vastaus.
refreshedAtstring (ISO 8601) | nullViimeisimmän onnistuneen Twitch-tarkistuksen ajankohta, ennen ensimmäistä tarkistusta null.
rateLimit{ limit, remaining, resetAt }Rajasi tällä reitillä tämän kutsun jälkeen, kuten ratelimit-*-otsakkeet sen kertovat: limit pyyntöä aikaikkunaa kohden, remaining vielä sallittua ja resetAt, jolloin koko raja on taas käytettävissä (ISO 8601).

Game

Yksi games-taulukon kohde.

KenttäTyyppiKuvaus
gameIdstringPelin Twitch-tunnus.
gameDisplayNamestringPelin nimi.
gameBoxArtURLstring (URL)Pelin kansikuva, 120×160.
startAtstring (ISO 8601)Pelin aikaisimman kampanjan alku.
endAtstring (ISO 8601)Pelin viimeisimmän kampanjan loppu.
rewardsDropCampaign[]Pelin Drops-kampanjat.
DropCampaign-, TimeBasedDrop- ja Benefit-kentät

DropCampaign

Drops-kampanja pelin rewards-kentässä.

KenttäTyyppiKuvaus
idstringKampanjan Twitch-tunnus.
name, descriptionstringJulkaisijan antama nimi ja kuvaus.
owner{ id, name }Kampanjaa pyörittävä julkaisija.
game{ id, displayName, slug }Kampanjan peli.
statusstringTwitch-tila, käynnissä olevalla kampanjalla ACTIVE.
startAt, endAtstring (ISO 8601)Kampanjan voimassaoloaika.
imageURLstring (URL)Kampanjan kuva.
detailsURL, accountLinkURLstring (URL)Julkaisijan tietosivu ja tilin yhdistämissivu.
allow{ isEnabled, channels? }Kanavat, jotka saavat jakaa Drops-palkintoja, kun isEnabled on true; muuten mikä tahansa peliä striimaava kanava. displayName voi olla null tai puuttua.
timeBasedDropsTimeBasedDrop[]Katsomalla ansaittavat Drops-palkinnot.
eventBasedDropsunknown[]Tapahtumilla ansaittavat Drops-palkinnot, välitetty sellaisenaan Twitchiltä.
firstSeenAtstring (ISO 8601) | nullMilloin tämä API näki kampanjan ensimmäisen kerran. Kampanja, joka palaa alle vuorokauden kuluttua listalta poistumisesta, säilyttää päivämääränsä. null kampanjoille, joita API jo tarjosi, kun tämä kenttä lisättiin.

TimeBasedDrop

Katsomalla ansaittava Drops-palkinto timeBasedDrops-kentässä.

KenttäTyyppiKuvaus
id, namestringPalkinnon Twitch-tunnus ja nimi.
startAt, endAtstring (ISO 8601)Ajanjakso, jona palkinnon voi ansaita.
requiredMinutesWatchednumberTarvittavat katseluminuutit.
requiredSubsnumberTarvittavat tilaukset.
repeat{ everyHours, times } | nullTämän API:n lisäämä: kuinka usein Dropin voi ansaita uudelleen, kentillä times (kuinka monta kertaa) ja everyHours (24: kerran päivässä; null, kun Twitch ei kerro). requiredMinutesWatched on silloin yhden jakson katseluaika. null, kun Drop ansaitaan kerran.
preconditionDropsunknownEnsin ansaittavat Drops-palkinnot, välitetty sellaisenaan Twitchiltä.
benefitEdges{ benefit: Benefit, entitlementLimit }[]Mitä palkinto antaa ja kuinka monta kertaa sen voi lunastaa.

Benefit

Pelinsisäinen esine benefitEdges-kentässä.

KenttäTyyppiKuvaus
id, namestringEsineen Twitch-tunnus ja nimi.
imageAssetURLstring (URL)Esineen kuva.
createdAtstring (ISO 8601)Esineen luontipäivä Twitchissä.
distributionTypestringMiten esine toimitetaan: DIRECT_ENTITLEMENT pelinsisäiselle esineelle, BADGE chattimerkille.
entitlementLimitnumberKuinka monta kertaa esineen voi lunastaa.
isIosAvailablebooleanVoiko esineen lunastaa iOS:ssä.
game, ownerOrganization{ id, name }Esineen peli ja julkaisija.

Vastauskoodit

TilaKuvaus
200Aktiiviset kampanjat. Tyhjä luettelo on kelvollinen vastaus.
304Mikään ei ole muuttunut lähettämäsi ETag-tunnisteen jälkeen: säilytä kopiosi. Maksuton, ei kuluta rajaasi.
429RATE_LIMITED: Odota Retry-After-otsakkeen ilmoittama määrä sekunteja.
429INVALID_API_KEY_RATE_LIMITED: Avainta ei tunnisteta, ja IP-osoitteesi anonyymi raja on käytetty: korjaa avain.
503SERVICE_UNAVAILABLE: Listaa ei ole vielä ladattu (heti API:n uudelleenkäynnistyksen jälkeen): yritä uudelleen Retry-After-ajan jälkeen. Maksuton, ei kuluta rajaasi.
Esimerkkipyyntö
curl https://drops.sunkwi.com/api/twitch/drops
Esimerkkivastaus · 200 OK
{  "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" }}

Hae palkintokampanjat

GEThttps://drops.sunkwi.com/api/twitch/rewards

Jokainen aktiivinen palkintokampanja (koko Twitchin tapahtumat, chattimerkit, kumppanipalkinnot) kentässä campaigns, mukana viimeisimmän Twitch-tarkistuksen ajankohta ja pyyntörajasi.

Vastauksen runko

KenttäTyyppiKuvaus
campaignsRewardCampaign[]Aktiiviset kampanjat viimeisimmän tarkistuksen järjestyksessä. Tyhjä taulukko on kelvollinen vastaus.
refreshedAtstring (ISO 8601) | nullViimeisimmän onnistuneen Twitch-tarkistuksen ajankohta, ennen ensimmäistä tarkistusta null.
rateLimit{ limit, remaining, resetAt }Rajasi tällä reitillä tämän kutsun jälkeen, kuten ratelimit-*-otsakkeet sen kertovat: limit pyyntöä aikaikkunaa kohden, remaining vielä sallittua ja resetAt, jolloin koko raja on taas käytettävissä (ISO 8601).

RewardCampaign

Yksi campaigns-taulukon kohde.

KenttäTyyppiKuvaus
id, name, brandstringKampanjan Twitch-tunnus, nimi ja brändi.
statusstringTila pyynnön hetkellä päivämäärien perusteella: UPCOMING ennen aikaa startsAt, ACTIVE aikaan endsAt asti, sen jälkeen EXPIRED.
summary, instructionsstringTwitchin näyttämät tekstit.
startsAt, endsAtstring (ISO 8601)Kampanjan voimassaoloaika.
image{ image1xURL }Kampanjan kuva.
aboutURL, externalURLstring (URL)Kampanjan ohjesivu ja ulkoinen sivu.
isSitewidebooleanLasketaanko jokainen kanava eikä vain yhden pelin kanavat.
game{ id, displayName, slug }?Kampanjan peli, jos sillä on sellainen.
rewardValueURLParamstringArvo, jonka Twitch lisää lunastuslinkkeihin.
unlockRequirements{ minuteWatchedGoal, subsGoal }Tarvittavat katseluminuutit ja tilaukset.
rewardGroupsRewardGroup[]?Palkinnot, jotka ansaitaan ryhmä kerrallaan, kullakin ryhmällä oma tavoitteensa: palkinto päivässä on ryhmä päivässä. Vain, kun Twitch lähettää ne.
rewardsReward[]Kampanjan palkinnot ryhmien palkinnot mukaan lukien, kukin kerran.
firstSeenAtstring (ISO 8601) | nullMilloin tämä API näki kampanjan ensimmäisen kerran. Kampanja, joka palaa alle vuorokauden kuluttua listalta poistumisesta, säilyttää päivämääränsä. null kampanjoille, joita API jo tarjosi, kun tämä kenttä lisättiin.
Palkintojen kentät

RewardGroup

Palkintokampanjan palkintoryhmä, jonka palkinnot ansaitaan yhdessä.

KenttäTyyppiKuvaus
idstringRyhmän Twitch-tunnus.
unlockRequirements{ minuteWatchedGoal, subsGoal, turboSubsGoal?, eventTriggerGoal? }Mitä ryhmä vaatii. Twitch lisää sinne myös Turbo- ja tapahtumatavoitteita.
repeat{ everyHours, times } | nullKuinka usein ryhmän voi ansaita uudelleen, kuten Dropin repeat: minuteWatchedGoal on silloin yhden jakson katseluaika. null, kun ryhmä ansaitaan kerran.
categories{ id, displayName, slug }[]Kategoriat, joiden suorat kanavat lasketaan, mikä tahansa niistä; tyhjä, kun Twitch ei nimeä yhtään.
rewardsReward[]Ryhmän palkinnot, jotka näkyvät myös kampanjan rewards-kentässä.

Reward

Palkintokampanjan palkinto.

KenttäTyyppiKuvaus
id, namestringPalkinnon Twitch-tunnus ja nimi.
bannerImage, thumbnailImage{ image1xURL }Palkinnon kuvat.
earnableUntilstring (ISO 8601)Viimeinen hetki, jolloin palkinnon voi ansaita.
redemptionInstructions, redemptionURLstringMiten ja missä palkinto lunastetaan.

Vastauskoodit

TilaKuvaus
200Aktiiviset kampanjat. Tyhjä luettelo on kelvollinen vastaus.
304Mikään ei ole muuttunut lähettämäsi ETag-tunnisteen jälkeen: säilytä kopiosi. Maksuton, ei kuluta rajaasi.
429RATE_LIMITED: Odota Retry-After-otsakkeen ilmoittama määrä sekunteja.
429INVALID_API_KEY_RATE_LIMITED: Avainta ei tunnisteta, ja IP-osoitteesi anonyymi raja on käytetty: korjaa avain.
503SERVICE_UNAVAILABLE: Listaa ei ole vielä ladattu (heti API:n uudelleenkäynnistyksen jälkeen): yritä uudelleen Retry-After-ajan jälkeen. Maksuton, ei kuluta rajaasi.
Esimerkkipyyntö
curl https://drops.sunkwi.com/api/twitch/rewards
Esimerkkivastaus · 200 OK
{  "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" }}

Hae chattimerkit

GEThttps://drops.sunkwi.com/api/twitch/badges

Twitchin yleiset chattimerkit kentässä badges, yksi kohde versiota kohden, kussakin tieto sen saamisesta, kun tämä API tietää sen (requirement), sekä Twitchin merkkien viimeisimmän haun ajankohta ja pyyntörajasi.

Vastauksen runko

KenttäTyyppiKuvaus
badgesBadge[]Yleiset merkit, yksi kohde versiota kohden. Tyhjä taulukko on kelvollinen vastaus.
refreshedAtstring (ISO 8601) | nullTwitchin merkkien viimeisimmän onnistuneen haun ajankohta (5 minuutin välein), ennen ensimmäistä hakua null.
rateLimit{ limit, remaining, resetAt }Rajasi tällä reitillä tämän kutsun jälkeen, kuten ratelimit-*-otsakkeet sen kertovat: limit pyyntöä aikaikkunaa kohden, remaining vielä sallittua ja resetAt, jolloin koko raja on taas käytettävissä (ISO 8601).

Badge

Yksi badges-taulukon kohde: yleisen chattimerkin yksi versio sellaisena kuin Twitch sen nyt listaa.

KenttäTyyppiKuvaus
setId, versionIdstringMerkkisarja ja sen versio: yhdessä ne yksilöivät yhden merkin (sub-gifter ja 5).
title, descriptionstringSen nimi ja Twitchin kuvaus englanniksi.
imageUrl1x, imageUrl2x, imageUrl4xstring (URL)Sen kuva kokoina 18, 36 ja 72 pikseliä.
clickAction, clickUrlstring | nullMitä Twitch tekee, kun merkkiä napsautetaan, ja sen linkki; null, kun Twitch ei anna sellaista.
firstSeenAtstring (ISO 8601) | nullMilloin tämä API näki merkin ensimmäisen kerran. Jos merkki palaa yli 7 päivää sen jälkeen, kun Twitch poisti sen, se saa uuden päivämäärän; jos se palaa aiemmin, se säilyttää vanhan. null merkeille, jotka olivat jo olemassa sen ensimmäisessä haussa.
requirementBadgeRequirement | nullMiten sen saa; null, kun tämä API ei tiedä.
BadgeRequirement-kentät

BadgeRequirement

Miten merkin saa: sen antavasta Drops-kampanjasta (DROPS) tai Twitchin omasta tilaaja- tai katselumerkin kuvauksesta (TWITCH_DESCRIPTION).

KenttäTyyppiKuvaus
source'DROPS' | 'TWITCH_DESCRIPTION'DROPS tai TWITCH_DESCRIPTION.
watchTimeOnlybooleantrue täsmälleen silloin, kun katsominen riittää: DROPS-kampanja, joka vaatii katseluaikaa (requiredMinutes yli 0) eikä tilausta (requiredSubs 0).
requiredMinutes, requiredSubsnumberVaaditut katseluminuutit sekä tilaukset tai lahjatilaukset.
gameId, gameNamestringPeli: sen Twitch-tunnus (null, jos tuntematon) ja nimi.
channels, channelCountstring[] (≤ 5), numberEnsimmäiset 5 kanavaa, jotka antavat sen (käyttäjätunnukset), ja niiden määrä; 0: mikä tahansa peliä striimaava kanava.
startAt, endAtstring (ISO 8601) | nullMilloin kampanja on käynnissä; null lähteelle TWITCH_DESCRIPTION. Päättynyt kampanja pysyy luettelossa.
campaignId, campaignNamestring | nullDrops-kampanja; null lähteelle TWITCH_DESCRIPTION.
repeat{ everyHours, times } | nullVain DROPS: katseluaika vaaditaan uudelleen joka jaksossa, ja requiredMinutes on yhden jakson aika, kentillä times ja everyHours (20 min päivässä 3 päivänä: times 3, everyHours 24); muuten null.
categories{ id, name }[] (≤ 50)Vain DROPS: kategoriat, joiden suorat kanavat lasketaan, mikä tahansa niistä (id ja name, enintään 50); gameId ja gameName ovat niistä ensimmäinen. Muuten tyhjä.
collection{ chestSize, completeAll } | nullVain DROPS: merkki on yksi tapahtumakokoelman eli kampanjan palkinnoista. chestSize: se tulee arkusta, jossa on näin monta palkintoa, yksi arkkua kohden, ei koskaan valittavissa (null: annetaan sellaisenaan). completeAll: annetaan koko kokoelman suorittamisesta, tilaukset mukaan lukien. Muuten null.
evolvesFrom{ setId, versionId } | nullVain DROPS: merkki, joka pitää valita chattiin ennen katsomista, tämän listan setId- ja versionId-arvoilla: Pokémonin kehitys vaatii edellisen vaiheensa (Pikachu: Pichu). Muuten null, tai kun sitä ei tiedetä.

Vastauskoodit

TilaKuvaus
200Yleiset merkit. Tyhjä luettelo on kelvollinen vastaus.
304Mikään ei ole muuttunut lähettämäsi ETag-tunnisteen jälkeen: säilytä kopiosi. Maksuton, ei kuluta rajaasi.
429RATE_LIMITED: Odota Retry-After-otsakkeen ilmoittama määrä sekunteja.
429INVALID_API_KEY_RATE_LIMITED: Avainta ei tunnisteta, ja IP-osoitteesi anonyymi raja on käytetty: korjaa avain.
503SERVICE_UNAVAILABLE: Listaa ei ole vielä ladattu (heti API:n uudelleenkäynnistyksen jälkeen): yritä uudelleen Retry-After-ajan jälkeen. Maksuton, ei kuluta rajaasi.
Esimerkkipyyntö
curl https://drops.sunkwi.com/api/twitch/badges
Ladataan esikatselua…

Pyyntörajat

Jokaisella reitillä on oma laskurinsa: /drops-kutsut eivät koskaan kuluta reittien /rewards tai /badges kiintiötä. Kampanjat muuttuvat kerran minuutissa ja merkit 5 minuutin välein, joten tiheämpi kysely ei tuo mitään uutta.

KutsujaRaja reittiä kohdenLaskentaperuste
Anonyymi1 pyyntö 5 minuutin väleinIP-osoite
API-avaimellaOletuksena 1 pyyntö pyyntöä minuutissa, pyynnöstä enemmänAPI-avain

Vastauksen otsakkeet

API:n lukemat ja lähettämät otsakkeet.

OtsakeSuuntaKuvaus
x-last-updated-atresponseViimeisimmän onnistuneen Twitch-haun ajankohta: tarkistus reiteille /drops ja /rewards, merkit reitille /badges.
x-refresh-interval-secondsresponseSekunteja kahden Twitch-haun välillä: tiheämpi kysely palauttaa samat tiedot (60 reiteille /drops ja /rewards, 300 reitille /badges).
ratelimit-limitresponseSallitut pyynnöt aikaikkunassa tällä reitillä.
ratelimit-remainingresponseJäljellä olevat pyynnöt nykyisessä aikaikkunassa.
ratelimit-resetresponseSekunteja siihen, kun pyyntö sallitaan taas.
ratelimit-policyresponseKäytäntö muodossa <raja>;w=<ikkuna sekunteina>.
retry-afterresponseSekunteja odotettavaksi ennen uutta yritystä, kun vastaus on 429 tai 503.
x-api-keyrequestAPI-avaimesi: valinnainen jokaisella reitillä.
x-api-key-statusresponseinvalid, kun lähetetty avain on tuntematon, mitätöity tai käytöstä poistettu: kutsu laskettiin anonyymiksi IP-osoitteesi rajaan.
etagresponseTämän vastauksen tunniste. Lähetä se takaisin If-None-Match-otsakkeessa: niin kauan kuin tiedot eivät muutu, vastaus on 304, joka ei kuluta rajaasi.
if-none-matchrequestViimeisimmän vastauksesi ETag, valinnainen: muuttumaton lista vastaa 304 Not Modified, maksutta.
Toinen anonyymi kutsu 5 minuutin sisällä
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" }

Virheet

Virheet palauttavat JSON-rungon, jossa on pysyvä koodi: { "code": "RATE_LIMITED" }. Koodit eivät koskaan muutu: rakenna code-kentän varaan, älä viestin.

TilaKoodiKuvaus
429RATE_LIMITEDLiikaa pyyntöjä tällä reitillä: odota Retry-After-otsakkeen ilmoittama määrä sekunteja.
429INVALID_API_KEY_RATE_LIMITEDLiikaa pyyntöjä, ja otsakkeessa X-API-Key on tuntematon, mitätöity tai käytöstä poistettu avain: kutsu laskettiin anonyymiksi. Korjaa avain tai odota Retry-After-otsakkeen ilmoittama määrä sekunteja.
503SERVICE_UNAVAILABLEListaa ei ole vielä ladattu (heti API:n uudelleenkäynnistyksen jälkeen). Mitään ei kulu: yritä uudelleen Retry-After-otsakkeen ilmoittaman sekuntimäärän kuluttua.
404NOT_FOUNDReittiä ei ole olemassa.
500INTERNAL_SERVER_ERRORPalvelimella tapahtui virhe: yritä myöhemmin uudelleen.
Esimerkkivirhe
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }

Sivusto ja API

Jokainen tämän sivuston sivu lukee näitä samoja reittejä. Tästä näet, missä kohtaa vastauksia sivulla näkyvä tieto on.

SivuReittiSijainti vastauksessa
Drops/drops/dropsgames: yksi kohde peliä kohden ja sen kampanjat kentässä rewards. Ruudukkonäkymä piirtää jokaisen kampanjan startAt- ja endAt-arvot.
Pelisivu/drops/<game>/dropsYksi games-taulukon kohde, tunnistettu gameId-kentän perusteella. Jokainen kampanja on games[i].rewards[j]; sen palkinnot ovat timeBasedDrops-kohteiden benefitEdges, ja katseluaika on kentässä requiredMinutesWatched.
Palkinnot/rewards/rewardscampaigns: yksi kohde palkintokampanjaa kohden, sen palkinnot kentässä rewards ja vaatimukset kentässä unlockRequirements.
Palkintokampanjasivu/rewards/<campaign>/rewardsYksi campaigns-taulukon kohde, tunnistettu id-kentän perusteella; sen palkinnot ovat kentässä rewards.
Merkit/badges/badgesbadges: kaikki kohteet, ensin ne, joilla on requirement, ja tieto niiden saamisesta. Ruudukkonäkymä piirtää jokaisen merkin requirement.startAt- ja requirement.endAt-arvot.
Merkkisivu/badges/<badge>/badgesYksi badges-taulukon kohde, tunnistettu setId- ja versionId-kenttien perusteella; ”Näin saat sen” on sen requirement.