Zum Inhalt springen
Twitch Drops API

Referenz der Twitch Drops API

Eine kostenlose JSON-API mit allen aktiven Twitch-Drops- und Belohnungskampagnen, jede Minute aktualisiert, und den globalen Chat-Abzeichen von Twitch. Ruf sie anonym auf oder mit einem kostenlosen API-Schlüssel für ein höheres Limit.

Basis-URLhttps://drops.sunkwi.com/api/twitch
Kostenlosen API-Schlüssel holenZur Referenz

Ausprobieren

Anonym: 1 Anfrage alle 5 Minuten pro Route. Mit Schlüssel: 1 pro Minute.

GET
Vorschau wird geladen…
Durchsuchen

Routen

Jede Route antwortet auf eine GET-Anfrage mit JSON, und Browser auf jeder Website können die API aufrufen (CORS). Weder /drops, /rewards noch /badges brauchen eine Registrierung; ein kostenloser API-Schlüssel erhöht das Limit bei jeder davon.

Die drei Routen antworten gleich: die Liste, die Uhrzeit des letzten Abrufs bei Twitch (refreshedAt) und dein Ratenlimit (rateLimit).

RouteBeschreibung
GET /dropsDrops-Kampagnen nach Spiel. Alle aktiven Drops-Kampagnen, nach Spiel gruppiert, in games: ein Eintrag pro Spiel, seine Kampagnen in rewards.
GET /rewardsBelohnungskampagnen. Alle aktiven Belohnungskampagnen (Twitch-weite Events, Chat-Abzeichen, Partnerbelohnungen), in campaigns.
GET /badgesGlobale Chat-Abzeichen. Die globalen Chat-Abzeichen von Twitch, ein Eintrag pro Version in badges, mit dem Weg, sie zu erhalten, wenn bekannt.

Authentifizierung

Zum Lesen von /drops, /rewards und /badges brauchst du weder Konto noch Schlüssel. Anonyme Aufrufe werden pro IP-Adresse gezählt: 1 Anfrage alle 5 Minuten pro Route.

Schlüssel sind kostenlos: Melde dich mit Discord, Twitch oder GitHub an, erstelle einen im Dashboard und sende ihn im Header X-API-Key. Ein Schlüssel hebt dein Limit standardmäßig auf 1 Anfrage pro Minute an, auf Anfrage auch höher, und zeigt dir deinen Traffic.

Anfrage-Header

HeaderWertBeschreibung
X-API-Keyjdk_…Dein API-Schlüssel: optional auf jeder Route. Ein unbekannter, widerrufener oder deaktivierter Schlüssel wird nie abgelehnt: Der Aufruf zählt als anonym, und x-api-key-status: invalid zeigt das an.
Beispielanfrage · 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

Kostenlosen API-Schlüssel holen

Ein Schlüssel ist kostenlos. Er hebt dein Limit von 1 Anfrage alle 5 Minuten auf 1 Anfrage pro Minute pro Route an, und dein Dashboard zeigt seinen Traffic.

  1. Melde dich mit Discord, Twitch oder GitHub an: kein Passwort, kein Formular.
  2. Öffne API-Schlüssel in deinem Dashboard und erstelle einen Schlüssel mit dem Namen deines Bots oder deiner Website.
  3. Kopiere den Schlüssel, sobald er angezeigt wird (nur einmal), und sende ihn von deinem Server im Header X-API-Key.

Drops-Kampagnen abrufen

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

Alle aktiven Drops-Kampagnen, nach Spiel gruppiert: ein Eintrag von games pro Spiel, seine Kampagnen in rewards, zusammen mit der Uhrzeit des letzten Twitch-Scans und deinem Ratenlimit.

Antwort-Body

FeldTypBeschreibung
gamesGame[]Die aktiven Kampagnen in der Reihenfolge des letzten Scans. Ein leeres Array ist eine gültige Antwort.
refreshedAtstring (ISO 8601) | nullZeitpunkt des letzten erfolgreichen Twitch-Scans, null vor dem ersten.
rateLimit{ limit, remaining, resetAt }Dein Limit auf dieser Route nach diesem Aufruf, wie es die ratelimit-*-Header angeben: limit Anfragen pro Zeitfenster, remaining noch erlaubt und resetAt, wann das volle Limit wieder verfügbar ist (ISO 8601).

Game

Ein Eintrag von games.

FeldTypBeschreibung
gameIdstringTwitch-ID des Spiels.
gameDisplayNamestringName des Spiels.
gameBoxArtURLstring (URL)Cover des Spiels, 120×160.
startAtstring (ISO 8601)Beginn der frühesten Kampagne des Spiels.
endAtstring (ISO 8601)Ende der spätesten Kampagne des Spiels.
rewardsDropCampaign[]Die Drops-Kampagnen des Spiels.
Felder von DropCampaign, TimeBasedDrop und Benefit

DropCampaign

Eine Drops-Kampagne, in rewards eines Spiels.

FeldTypBeschreibung
idstringTwitch-ID der Kampagne.
name, descriptionstringName und Beschreibung vom Publisher.
owner{ id, name }Publisher, der die Kampagne durchführt.
game{ id, displayName, slug }Spiel der Kampagne.
statusstringTwitch-Status, ACTIVE bei einer laufenden Kampagne.
startAt, endAtstring (ISO 8601)Laufzeit der Kampagne.
imageURLstring (URL)Kampagnenbild.
detailsURL, accountLinkURLstring (URL)Detailseite und Seite zur Kontoverknüpfung des Publishers.
allow{ isEnabled, channels? }Kanäle, die die Drops vergeben dürfen, wenn isEnabled true ist; sonst jeder Kanal, der das Spiel streamt. displayName kann null sein oder fehlen.
timeBasedDropsTimeBasedDrop[]Drops, die man durch Zuschauen erhält.
eventBasedDropsunknown[]Drops, die man durch Events erhält, unverändert von Twitch übernommen.
firstSeenAtstring (ISO 8601) | nullWann diese API die Kampagne zum ersten Mal gesehen hat. Eine Kampagne, die weniger als einen Tag nach dem Verlassen der Liste zurückkommt, behält ihr Datum. null für die Kampagnen, die die API schon lieferte, als dieses Feld hinzukam.

TimeBasedDrop

Ein Drop, den man durch Zuschauen erhält, in timeBasedDrops.

FeldTypBeschreibung
id, namestringTwitch-ID und Name des Drops.
startAt, endAtstring (ISO 8601)Zeitraum, in dem der Drop erhältlich ist.
requiredMinutesWatchednumberBenötigte Zuschauminuten.
requiredSubsnumberBenötigte Abos.
repeat{ everyHours, times } | nullVon dieser API ergänzt: wie oft der Drop erneut verdient wird, mit times (wie oft) und everyHours (24: einmal am Tag; null, wenn Twitch es nicht angibt). requiredMinutesWatched ist dann die Zuschauzeit eines Zeitraums. null für einen Drop, der einmal verdient wird.
preconditionDropsunknownDrops, die man zuerst erhalten muss, unverändert von Twitch übernommen.
benefitEdges{ benefit: Benefit, entitlementLimit }[]Was der Drop gibt und wie oft man es abholen kann.

Benefit

Ein In-Game-Item, in benefitEdges.

FeldTypBeschreibung
id, namestringTwitch-ID und Name des Items.
imageAssetURLstring (URL)Bild des Items.
createdAtstring (ISO 8601)Erstellungsdatum des Items auf Twitch.
distributionTypestringWie das Item ausgeliefert wird: DIRECT_ENTITLEMENT für ein In-Game-Item, BADGE für ein Chat-Abzeichen.
entitlementLimitnumberWie oft das Item abgeholt werden kann.
isIosAvailablebooleanOb das Item unter iOS abgeholt werden kann.
game, ownerOrganization{ id, name }Spiel und Publisher des Items.

Antwortcodes

StatusBeschreibung
200Die aktiven Kampagnen. Eine leere Liste ist eine gültige Antwort.
304Seit dem gesendeten ETag hat sich nichts geändert: Behalte deine Kopie. Kostenlos, wird nicht auf dein Limit angerechnet.
429RATE_LIMITED: Warte die in Retry-After angegebenen Sekunden.
429INVALID_API_KEY_RATE_LIMITED: Der Schlüssel wird nicht erkannt und das anonyme Limit deiner IP-Adresse ist aufgebraucht: Korrigiere den Schlüssel.
503SERVICE_UNAVAILABLE: Noch keine Liste geladen (direkt nach einem Neustart der API): Versuche es nach Retry-After erneut. Kostenlos, wird nicht auf dein Limit angerechnet.
Beispielanfrage
curl https://drops.sunkwi.com/api/twitch/drops
Beispielantwort · 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" }}

Belohnungskampagnen abrufen

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

Alle aktiven Belohnungskampagnen (Twitch-weite Events, Chat-Abzeichen, Partnerbelohnungen) in campaigns, zusammen mit der Uhrzeit des letzten Twitch-Scans und deinem Ratenlimit.

Antwort-Body

FeldTypBeschreibung
campaignsRewardCampaign[]Die aktiven Kampagnen in der Reihenfolge des letzten Scans. Ein leeres Array ist eine gültige Antwort.
refreshedAtstring (ISO 8601) | nullZeitpunkt des letzten erfolgreichen Twitch-Scans, null vor dem ersten.
rateLimit{ limit, remaining, resetAt }Dein Limit auf dieser Route nach diesem Aufruf, wie es die ratelimit-*-Header angeben: limit Anfragen pro Zeitfenster, remaining noch erlaubt und resetAt, wann das volle Limit wieder verfügbar ist (ISO 8601).

RewardCampaign

Ein Eintrag von campaigns.

FeldTypBeschreibung
id, name, brandstringTwitch-ID, Name und Marke der Kampagne.
statusstringStatus zum Zeitpunkt der Anfrage, anhand der Datumsangaben: UPCOMING vor startsAt, ACTIVE bis endsAt, danach EXPIRED.
summary, instructionsstringVon Twitch angezeigte Texte.
startsAt, endsAtstring (ISO 8601)Laufzeit der Kampagne.
image{ image1xURL }Kampagnenbild.
aboutURL, externalURLstring (URL)Hilfeseite und externe Seite der Kampagne.
isSitewidebooleanOb jeder Kanal zählt, nicht nur die eines Spiels.
game{ id, displayName, slug }?Spiel der Kampagne, falls vorhanden.
rewardValueURLParamstringWert, den Twitch an die Einlöse-Links anhängt.
unlockRequirements{ minuteWatchedGoal, subsGoal }Benötigte Zuschauminuten und Abos.
rewardGroupsRewardGroup[]?Belohnungen, die man gruppenweise erhält, jede Gruppe mit eigenem Ziel: eine Belohnung pro Tag ist eine Gruppe pro Tag. Nur wenn Twitch sie sendet.
rewardsReward[]Die Belohnungen der Kampagne, einschließlich derer ihrer Gruppen, jede nur einmal.
firstSeenAtstring (ISO 8601) | nullWann diese API die Kampagne zum ersten Mal gesehen hat. Eine Kampagne, die weniger als einen Tag nach dem Verlassen der Liste zurückkommt, behält ihr Datum. null für die Kampagnen, die die API schon lieferte, als dieses Feld hinzukam.
Felder der Belohnungen

RewardGroup

Eine Gruppe von Belohnungen einer Belohnungskampagne, die man zusammen erhält.

FeldTypBeschreibung
idstringTwitch-ID der Gruppe.
unlockRequirements{ minuteWatchedGoal, subsGoal, turboSubsGoal?, eventTriggerGoal? }Was die Gruppe verlangt. Twitch ergänzt dort Turbo- und Event-Ziele.
repeat{ everyHours, times } | nullWie oft die Gruppe erneut verdient wird, wie repeat eines Drops: minuteWatchedGoal ist dann die Zuschauzeit eines Zeitraums. null für eine Gruppe, die einmal verdient wird.
categories{ id, displayName, slug }[]Die Kategorien, deren Live-Kanäle zählen, beliebig welche; leer, wenn Twitch keine nennt.
rewardsReward[]Die Belohnungen der Gruppe, auch in rewards der Kampagne aufgeführt.

Reward

Eine Belohnung einer Belohnungskampagne.

FeldTypBeschreibung
id, namestringTwitch-ID und Name der Belohnung.
bannerImage, thumbnailImage{ image1xURL }Bilder der Belohnung.
earnableUntilstring (ISO 8601)Letzter Zeitpunkt, zu dem man die Belohnung erhalten kann.
redemptionInstructions, redemptionURLstringWie und wo die Belohnung eingelöst wird.

Antwortcodes

StatusBeschreibung
200Die aktiven Kampagnen. Eine leere Liste ist eine gültige Antwort.
304Seit dem gesendeten ETag hat sich nichts geändert: Behalte deine Kopie. Kostenlos, wird nicht auf dein Limit angerechnet.
429RATE_LIMITED: Warte die in Retry-After angegebenen Sekunden.
429INVALID_API_KEY_RATE_LIMITED: Der Schlüssel wird nicht erkannt und das anonyme Limit deiner IP-Adresse ist aufgebraucht: Korrigiere den Schlüssel.
503SERVICE_UNAVAILABLE: Noch keine Liste geladen (direkt nach einem Neustart der API): Versuche es nach Retry-After erneut. Kostenlos, wird nicht auf dein Limit angerechnet.
Beispielanfrage
curl https://drops.sunkwi.com/api/twitch/rewards
Beispielantwort · 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" }}

Chat-Abzeichen abrufen

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

Die globalen Chat-Abzeichen von Twitch in badges, ein Eintrag pro Version, jeweils mit dem Weg zum Abzeichen, sofern diese API ihn kennt (requirement), zusammen mit der Uhrzeit des letzten Abrufs der Twitch-Abzeichen und deinem Ratenlimit.

Antwort-Body

FeldTypBeschreibung
badgesBadge[]Die globalen Abzeichen, ein Eintrag pro Version. Ein leeres Array ist eine gültige Antwort.
refreshedAtstring (ISO 8601) | nullZeitpunkt des letzten erfolgreichen Abrufs der Twitch-Abzeichen (alle 5 Minuten), null vor dem ersten.
rateLimit{ limit, remaining, resetAt }Dein Limit auf dieser Route nach diesem Aufruf, wie es die ratelimit-*-Header angeben: limit Anfragen pro Zeitfenster, remaining noch erlaubt und resetAt, wann das volle Limit wieder verfügbar ist (ISO 8601).

Badge

Ein Eintrag von badges: eine Version eines globalen Chat-Abzeichens, wie Twitch es gerade listet.

FeldTypBeschreibung
setId, versionIdstringDas Abzeichen-Set und seine Version: Zusammen benennen sie ein Abzeichen (sub-gifter und 5).
title, descriptionstringSein Name und die Beschreibung von Twitch, auf Englisch.
imageUrl1x, imageUrl2x, imageUrl4xstring (URL)Sein Bild in 18, 36 und 72 Pixeln.
clickAction, clickUrlstring | nullWas Twitch beim Klick auf das Abzeichen tut, und sein Link; null, wenn Twitch keinen angibt.
firstSeenAtstring (ISO 8601) | nullWann diese API das Abzeichen zum ersten Mal gesehen hat. Kommt ein Abzeichen mehr als 7 Tage, nachdem Twitch es entfernt hat, zurück, erhält es ein neues Datum; kommt es früher zurück, behält es sein altes. null für die Abzeichen, die bei ihrem ersten Abruf schon da waren.
requirementBadgeRequirement | nullWie man es erhält; null, wenn diese API es nicht weiß.
Felder von BadgeRequirement

BadgeRequirement

Wie man ein Abzeichen erhält: über die Drops-Kampagne, die es vergibt (DROPS), oder laut Twitchs eigener Beschreibung eines Abo- oder Zuschau-Abzeichens (TWITCH_DESCRIPTION).

FeldTypBeschreibung
source'DROPS' | 'TWITCH_DESCRIPTION'DROPS oder TWITCH_DESCRIPTION.
watchTimeOnlybooleanGenau dann true, wenn Zuschauen reicht: eine DROPS-Kampagne, die Zuschauzeit verlangt (requiredMinutes über 0) und kein Abo (requiredSubs 0).
requiredMinutes, requiredSubsnumberDie nötigen Zuschauminuten sowie Abos oder verschenkten Abos.
gameId, gameNamestringDas Spiel: seine Twitch-ID (null, wenn unbekannt) und sein Name.
channels, channelCountstring[] (≤ 5), numberDie ersten 5 Kanäle, die es vergeben (Logins), und wie viele es sind; 0: jeder Kanal, der das Spiel streamt.
startAt, endAtstring (ISO 8601) | nullLaufzeit der Kampagne; null bei TWITCH_DESCRIPTION. Eine beendete Kampagne bleibt.
campaignId, campaignNamestring | nullDie Drops-Kampagne; null bei TWITCH_DESCRIPTION.
repeat{ everyHours, times } | nullNur DROPS: Die Zuschauzeit wird in jedem Zeitraum erneut verlangt, requiredMinutes gilt für einen Zeitraum, mit times und everyHours (20 Min. pro Tag an 3 Tagen: times 3, everyHours 24); sonst null.
categories{ id, name }[] (≤ 50)Nur DROPS: die Kategorien, deren Live-Kanäle zählen, beliebig welche (id und name, höchstens 50); gameId und gameName sind die erste davon. Sonst leer.
collection{ chestSize, completeAll } | nullNur DROPS: Das Abzeichen ist eine Belohnung einer Event-Sammlung, der Kampagne. chestSize: Es kommt aus einer Truhe mit so vielen Belohnungen, eine pro Truhe, nie frei wählbar (null: direkt vergeben). completeAll: vergeben für den Abschluss der ganzen Sammlung, Abos inklusive. Sonst null.
evolvesFrom{ setId, versionId } | nullNur DROPS: das Abzeichen, das du vor dem Zuschauen im Chat anlegen musst, über sein setId und versionId in dieser Liste: Eine Pokémon-Entwicklung verlangt ihre vorige Stufe (Pikachu: Pichu). Sonst null, oder wenn unbekannt.

Antwortcodes

StatusBeschreibung
200Die globalen Abzeichen. Eine leere Liste ist eine gültige Antwort.
304Seit dem gesendeten ETag hat sich nichts geändert: Behalte deine Kopie. Kostenlos, wird nicht auf dein Limit angerechnet.
429RATE_LIMITED: Warte die in Retry-After angegebenen Sekunden.
429INVALID_API_KEY_RATE_LIMITED: Der Schlüssel wird nicht erkannt und das anonyme Limit deiner IP-Adresse ist aufgebraucht: Korrigiere den Schlüssel.
503SERVICE_UNAVAILABLE: Noch keine Liste geladen (direkt nach einem Neustart der API): Versuche es nach Retry-After erneut. Kostenlos, wird nicht auf dein Limit angerechnet.
Beispielanfrage
curl https://drops.sunkwi.com/api/twitch/badges
Vorschau wird geladen…

Ratenlimits

Jede Route hat ihren eigenen Zähler: Ein Aufruf von /drops verbraucht nie das Kontingent von /rewards oder /badges. Die Kampagnen ändern sich einmal pro Minute und die Abzeichen alle 5 Minuten, häufigeres Abfragen bringt also nichts Neues.

AufruferLimit pro RouteGezählt pro
Anonym1 Anfrage alle 5 MinutenIP-Adresse
Mit API-SchlüsselStandardmäßig 1 Anfrage pro Minute, auf Anfrage mehrAPI-Schlüssel

Antwort-Header

Header, die die API liest und sendet.

HeaderRichtungBeschreibung
x-last-updated-atresponseZeitpunkt des letzten erfolgreichen Abrufs bei Twitch: der Scan für /drops und /rewards, die Abzeichen für /badges.
x-refresh-interval-secondsresponseSekunden zwischen zwei Abrufen bei Twitch: Häufigere Anfragen liefern dieselben Daten (60 für /drops und /rewards, 300 für /badges).
ratelimit-limitresponseErlaubte Anfragen im Zeitfenster, für diese Route.
ratelimit-remainingresponseVerbleibende Anfragen im aktuellen Zeitfenster.
ratelimit-resetresponseSekunden, bis wieder eine Anfrage erlaubt ist.
ratelimit-policyresponseDie Richtlinie, als <Limit>;w=<Fenster in Sekunden>.
retry-afterresponseSekunden bis zum nächsten Versuch, bei einer 429- oder 503-Antwort.
x-api-keyrequestDein API-Schlüssel: optional auf jeder Route.
x-api-key-statusresponseinvalid, wenn der gesendete Schlüssel unbekannt, widerrufen oder deaktiviert ist: Der Aufruf zählte als anonym, gegen das Limit deiner IP-Adresse.
etagresponseKennzeichen dieser Antwort. Schicke es in If-None-Match zurück: Solange sich die Daten nicht geändert haben, ist die Antwort ein 304, der nicht auf dein Limit angerechnet wird.
if-none-matchrequestDas ETag deiner letzten Antwort, optional: Eine unveränderte Liste antwortet mit 304 Not Modified, kostenlos.
Ein zweiter anonymer Aufruf innerhalb von 5 Minuten
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" }

Fehler

Fehler liefern einen JSON-Body mit einem festen Code: { "code": "RATE_LIMITED" }. Codes ändern sich nie: Verlass dich auf code, nicht auf eine Meldung.

StatusCodeBeschreibung
429RATE_LIMITEDZu viele Anfragen auf dieser Route: Warte die in Retry-After angegebenen Sekunden.
429INVALID_API_KEY_RATE_LIMITEDZu viele Anfragen, und der Header X-API-Key enthält einen unbekannten, widerrufenen oder deaktivierten Schlüssel: Der Aufruf zählte als anonym. Korrigiere den Schlüssel oder warte die in Retry-After angegebenen Sekunden.
503SERVICE_UNAVAILABLENoch keine Liste geladen (direkt nach einem Neustart der API). Nichts wird verbraucht: Versuche es nach den in Retry-After angegebenen Sekunden erneut.
404NOT_FOUNDDie Route existiert nicht.
500INTERNAL_SERVER_ERRORServerfehler: Versuche es später erneut.
Beispielfehler
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }

Von der Website zur API

Jede Seite dieser Website liest dieselben Routen. Hier steht, wo das, was eine Seite zeigt, in den Antworten zu finden ist.

SeiteRouteWo in der Antwort
Drops/drops/dropsgames: ein Eintrag pro Spiel, seine Kampagnen in rewards. Die Rasteransicht zeichnet startAt und endAt jeder Kampagne.
Eine Spielseite/drops/<game>/dropsEin Eintrag von games, zugeordnet über gameId. Jede Kampagne ist games[i].rewards[j]; ihre Belohnungen sind die benefitEdges von timeBasedDrops, mit requiredMinutesWatched.
Belohnungen/rewards/rewardscampaigns: ein Eintrag pro Belohnungskampagne, ihre Belohnungen in rewards und ihre Anforderungen in unlockRequirements.
Eine Belohnungskampagnenseite/rewards/<campaign>/rewardsEin Eintrag von campaigns, zugeordnet über id; seine Belohnungen stehen in rewards.
Abzeichen/badges/badgesbadges: alle Einträge, die mit einem requirement zuerst, jeweils mit dem Weg, sie zu erhalten. Die Rasteransicht zeichnet requirement.startAt und requirement.endAt jedes Abzeichens.
Eine Abzeichenseite/badges/<badge>/badgesEin Eintrag von badges, zugeordnet über setId und versionId; „So erhältst du es“ ist sein requirement.