सामग्री पर जाएं
Twitch Drops API

Twitch Drops API संदर्भ

एक मुफ़्त JSON API, जो हर चालू Twitch Drops और इनाम अभियान की सूची देता है, हर मिनट अपडेट होता है, और Twitch के ग्लोबल चैट बैज भी देता है। इसे अनाम रूप से कॉल करें, या ज़्यादा सीमा के लिए मुफ़्त API कुंजी के साथ।

बेस URLhttps://drops.sunkwi.com/api/twitch
मुफ़्त API कुंजी पाएंसंदर्भ पढ़ें

आज़माएं

अनाम: हर रूट पर हर 5 मिनट में 1 अनुरोध। कुंजी के साथ: 1 प्रति मिनट।

GET
प्रीव्यू लोड हो रहा है…
ब्राउज़ करें

रूट

हर रूट GET अनुरोध का जवाब JSON में देता है, और किसी भी साइट के ब्राउज़र API को कॉल कर सकते हैं (CORS)। न /drops, न /rewards, न /badges के लिए साइन अप ज़रूरी है; मुफ़्त API कुंजी हर एक की सीमा बढ़ा देती है।

तीनों रूट एक ही तरह से जवाब देते हैं: सूची, Twitch को आखिरी बार पढ़ने का समय (refreshedAt) और आपकी अनुरोध सीमा (rateLimit)।

रूटविवरण
GET /dropsगेम के हिसाब से Drops अभियान. हर चालू Drops अभियान, गेम के हिसाब से समूहित, games में: हर गेम का एक आइटम, उसके अभियान rewards में।
GET /rewardsइनाम अभियान. हर चालू इनाम अभियान (पूरे Twitch के इवेंट, चैट बैज, पार्टनर इनाम), campaigns में।
GET /badgesग्लोबल चैट बैज. Twitch के ग्लोबल चैट बैज, badges में हर वर्शन का एक आइटम, और पता होने पर उन्हें पाने का तरीका।

प्रमाणीकरण

/drops, /rewards और /badges पढ़ने के लिए न खाता चाहिए, न कुंजी। अनाम कॉल IP पते के हिसाब से गिनी जाती हैं: हर रूट पर हर 5 मिनट में 1 अनुरोध।

कुंजियां मुफ़्त हैं: Discord, Twitch या GitHub से साइन इन करें, डैशबोर्ड में एक कुंजी बनाएं और उसे X-API-Key हेडर में भेजें। कुंजी डिफ़ॉल्ट रूप से आपकी सीमा 1 अनुरोध प्रति मिनट कर देती है, जो अनुरोध पर और बढ़ाई जा सकती है, और आपका ट्रैफ़िक दिखाती है।

अनुरोध हेडर

हेडरमानविवरण
X-API-Keyjdk_…आपकी API कुंजी: हर रूट पर वैकल्पिक। अनजान, रद्द या बंद की गई कुंजी कभी अस्वीकार नहीं होती: कॉल अनाम गिनी जाती है, और x-api-key-status: invalid यही बताता है।
अनुरोध का उदाहरण · 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

मुफ़्त API कुंजी पाएं

कुंजी मुफ़्त है। यह हर रूट पर आपकी सीमा हर 5 मिनट में 1 अनुरोध से बढ़ाकर 1 अनुरोध प्रति मिनट कर देती है, और आपका डैशबोर्ड इसका ट्रैफ़िक दिखाता है।

  1. Discord, Twitch या GitHub से साइन इन करें: न पासवर्ड, न फ़ॉर्म।
  2. अपने डैशबोर्ड में API कुंजियां खोलें और अपने बॉट या साइट के नाम पर एक कुंजी बनाएं।
  3. कुंजी दिखते ही उसे कॉपी करें (यह सिर्फ़ एक बार दिखती है) और अपने सर्वर से उसे X-API-Key हेडर में भेजें।

Drops अभियान पाएं

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

हर चालू Drops अभियान, गेम के हिसाब से समूहित: हर गेम का games में एक आइटम, उसके अभियान rewards में, और साथ में पिछले Twitch स्कैन का समय और आपकी अनुरोध सीमा।

जवाब की बॉडी

फ़ील्डप्रकारविवरण
gamesGame[]चालू अभियान, पिछले स्कैन के क्रम में। खाली ऐरे भी एक मान्य जवाब है।
refreshedAtstring (ISO 8601) | nullपिछले सफल Twitch स्कैन का समय, पहले स्कैन से पहले null।
rateLimit{ limit, remaining, resetAt }इस कॉल के बाद इस रूट पर आपकी सीमा, जैसा ratelimit-* हेडर बताते हैं: हर विंडो में limit अनुरोध, remaining अब भी अनुमत, और resetAt, जब पूरी सीमा वापस मिलती है (ISO 8601)।

Game

games का एक आइटम।

फ़ील्डप्रकारविवरण
gameIdstringगेम का Twitch ID।
gameDisplayNamestringगेम का नाम।
gameBoxArtURLstring (URL)गेम का कवर, 120×160।
startAtstring (ISO 8601)गेम के सबसे पहले अभियान की शुरुआत।
endAtstring (ISO 8601)गेम के सबसे आखिर में खत्म होने वाले अभियान का अंत।
rewardsDropCampaign[]गेम के Drops अभियान।
DropCampaign, TimeBasedDrop और Benefit के फ़ील्ड

DropCampaign

एक Drops अभियान, किसी गेम के rewards में।

फ़ील्डप्रकारविवरण
idstringअभियान का Twitch ID।
name, descriptionstringपब्लिशर का दिया नाम और विवरण।
owner{ id, name }अभियान चलाने वाला पब्लिशर।
game{ id, displayName, slug }अभियान का गेम।
statusstringTwitch स्थिति, चल रहे अभियान के लिए ACTIVE।
startAt, endAtstring (ISO 8601)अभियान की अवधि।
imageURLstring (URL)अभियान की तस्वीर।
detailsURL, accountLinkURLstring (URL)पब्लिशर का विवरण पेज और खाता लिंक करने का पेज।
allow{ isEnabled, channels? }isEnabled true होने पर Drops देने की अनुमति वाले चैनल; वरना गेम स्ट्रीम करने वाला कोई भी चैनल। displayName null हो सकता है या मौजूद नहीं भी हो सकता।
timeBasedDropsTimeBasedDrop[]देखकर मिलने वाले Drops।
eventBasedDropsunknown[]इवेंट से मिलने वाले Drops, Twitch से जैसे के तैसे।
firstSeenAtstring (ISO 8601) | nullइस API ने कैंपेन को पहली बार कब देखा। सूची से हटने के एक दिन के अंदर लौटा कैंपेन अपनी तारीख रखता है। यह फ़ील्ड आने के समय API जिन कैंपेन को पहले से दे रहा था, उनके लिए null।

TimeBasedDrop

देखकर मिलने वाला एक Drop, timeBasedDrops में।

फ़ील्डप्रकारविवरण
id, namestringDrop का Twitch ID और नाम।
startAt, endAtstring (ISO 8601)वह अवधि जिसमें Drop पाया जा सकता है।
requiredMinutesWatchednumberदेखने के ज़रूरी मिनट।
requiredSubsnumberज़रूरी सब्सक्रिप्शन।
repeat{ everyHours, times } | nullयह API जोड़ता है: Drop कितनी बार दोबारा मिलता है, times (कितनी बार) और everyHours (24: दिन में एक बार; Twitch न बताए तो null) के साथ। तब requiredMinutesWatched एक अवधि का देखने का समय है। एक ही बार मिलने वाले Drop के लिए null।
preconditionDropsunknownपहले पाने वाले Drops, Twitch से जैसे के तैसे।
benefitEdges{ benefit: Benefit, entitlementLimit }[]Drop क्या देता है, और उसे कितनी बार क्लेम किया जा सकता है।

Benefit

एक इन-गेम आइटम, benefitEdges में।

फ़ील्डप्रकारविवरण
id, namestringआइटम का Twitch ID और नाम।
imageAssetURLstring (URL)आइटम की तस्वीर।
createdAtstring (ISO 8601)Twitch पर आइटम बनने की तारीख।
distributionTypestringआइटम कैसे दिया जाता है: इन-गेम आइटम के लिए DIRECT_ENTITLEMENT, चैट बैज के लिए BADGE।
entitlementLimitnumberआइटम कितनी बार क्लेम किया जा सकता है।
isIosAvailablebooleanक्या आइटम iOS पर क्लेम किया जा सकता है।
game, ownerOrganization{ id, name }आइटम का गेम और पब्लिशर।

जवाब कोड

स्थितिविवरण
200चालू अभियान। खाली सूची भी एक मान्य जवाब है।
304भेजे गए ETag के बाद से कुछ नहीं बदला: अपनी कॉपी रखें। मुफ़्त, आपकी सीमा में नहीं गिना जाता।
429RATE_LIMITED: Retry-After में दिए गए सेकंड तक रुकें।
429INVALID_API_KEY_RATE_LIMITED: कुंजी पहचानी नहीं गई और आपके IP पते की अनाम सीमा खत्म हो चुकी है: कुंजी ठीक करें।
503SERVICE_UNAVAILABLE: अभी कोई सूची लोड नहीं हुई (API के दोबारा शुरू होने के ठीक बाद): Retry-After के बाद फिर से कोशिश करें। मुफ़्त, आपकी सीमा में नहीं गिना जाता।
अनुरोध का उदाहरण
curl https://drops.sunkwi.com/api/twitch/drops
जवाब का उदाहरण · 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" }}

इनाम अभियान पाएं

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

हर चालू इनाम अभियान (पूरे Twitch के इवेंट, चैट बैज, पार्टनर इनाम) campaigns में, साथ में पिछले Twitch स्कैन का समय और आपकी अनुरोध सीमा।

जवाब की बॉडी

फ़ील्डप्रकारविवरण
campaignsRewardCampaign[]चालू अभियान, पिछले स्कैन के क्रम में। खाली ऐरे भी एक मान्य जवाब है।
refreshedAtstring (ISO 8601) | nullपिछले सफल Twitch स्कैन का समय, पहले स्कैन से पहले null।
rateLimit{ limit, remaining, resetAt }इस कॉल के बाद इस रूट पर आपकी सीमा, जैसा ratelimit-* हेडर बताते हैं: हर विंडो में limit अनुरोध, remaining अब भी अनुमत, और resetAt, जब पूरी सीमा वापस मिलती है (ISO 8601)।

RewardCampaign

campaigns का एक आइटम।

फ़ील्डप्रकारविवरण
id, name, brandstringअभियान का Twitch ID, नाम और ब्रांड।
statusstringअनुरोध के समय की स्थिति, तारीखों से तय: startsAt से पहले UPCOMING, endsAt तक ACTIVE, फिर EXPIRED।
summary, instructionsstringTwitch द्वारा दिखाए गए टेक्स्ट।
startsAt, endsAtstring (ISO 8601)अभियान की अवधि।
image{ image1xURL }अभियान की तस्वीर।
aboutURL, externalURLstring (URL)अभियान का सहायता पेज और बाहरी पेज।
isSitewidebooleanक्या हर चैनल गिना जाता है, सिर्फ़ किसी गेम के चैनल नहीं।
game{ id, displayName, slug }?अभियान का गेम, अगर हो।
rewardValueURLParamstringवह मान जो Twitch रिडेम्पशन लिंक में जोड़ता है।
unlockRequirements{ minuteWatchedGoal, subsGoal }देखने के ज़रूरी मिनट और सब्सक्रिप्शन।
rewardGroupsRewardGroup[]?एक बार में एक समूह के रूप में मिलने वाले इनाम, हर समूह का अपना लक्ष्य: रोज़ एक इनाम का मतलब है रोज़ एक समूह। सिर्फ़ तब, जब Twitch इन्हें भेजता है।
rewardsReward[]अभियान के इनाम, उसके समूहों के इनाम समेत, हर इनाम एक बार।
firstSeenAtstring (ISO 8601) | nullइस API ने कैंपेन को पहली बार कब देखा। सूची से हटने के एक दिन के अंदर लौटा कैंपेन अपनी तारीख रखता है। यह फ़ील्ड आने के समय API जिन कैंपेन को पहले से दे रहा था, उनके लिए null।
इनाम के फ़ील्ड

RewardGroup

किसी इनाम अभियान के इनामों का एक समूह, जो साथ में मिलते हैं।

फ़ील्डप्रकारविवरण
idstringसमूह का Twitch ID।
unlockRequirements{ minuteWatchedGoal, subsGoal, turboSubsGoal?, eventTriggerGoal? }समूह की शर्तें। Twitch यहां Turbo और इवेंट के लक्ष्य जोड़ता है।
repeat{ everyHours, times } | nullग्रुप कितनी बार दोबारा मिलता है, Drop के repeat की तरह: तब minuteWatchedGoal एक अवधि का देखने का समय है। एक ही बार मिलने वाले ग्रुप के लिए null।
categories{ id, displayName, slug }[]वे कैटेगरी जिनके लाइव चैनल गिने जाते हैं, उनमें से कोई भी; Twitch कोई न बताए तो खाली।
rewardsReward[]समूह के इनाम, जो अभियान के rewards में भी दिए गए हैं।

Reward

किसी इनाम अभियान का एक इनाम।

फ़ील्डप्रकारविवरण
id, namestringइनाम का Twitch ID और नाम।
bannerImage, thumbnailImage{ image1xURL }इनाम की तस्वीरें।
earnableUntilstring (ISO 8601)इनाम पाने का आखिरी समय।
redemptionInstructions, redemptionURLstringइनाम कैसे और कहां रिडीम करें।

जवाब कोड

स्थितिविवरण
200चालू अभियान। खाली सूची भी एक मान्य जवाब है।
304भेजे गए ETag के बाद से कुछ नहीं बदला: अपनी कॉपी रखें। मुफ़्त, आपकी सीमा में नहीं गिना जाता।
429RATE_LIMITED: Retry-After में दिए गए सेकंड तक रुकें।
429INVALID_API_KEY_RATE_LIMITED: कुंजी पहचानी नहीं गई और आपके IP पते की अनाम सीमा खत्म हो चुकी है: कुंजी ठीक करें।
503SERVICE_UNAVAILABLE: अभी कोई सूची लोड नहीं हुई (API के दोबारा शुरू होने के ठीक बाद): Retry-After के बाद फिर से कोशिश करें। मुफ़्त, आपकी सीमा में नहीं गिना जाता।
अनुरोध का उदाहरण
curl https://drops.sunkwi.com/api/twitch/rewards
जवाब का उदाहरण · 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" }}

चैट बैज पाएं

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

Twitch के ग्लोबल चैट बैज badges में, हर वर्शन का एक आइटम, और जब यह API जानता है तो हर एक को पाने का तरीका (requirement), साथ में Twitch के बैज को पिछली बार पढ़ने का समय और आपकी अनुरोध सीमा।

जवाब की बॉडी

फ़ील्डप्रकारविवरण
badgesBadge[]ग्लोबल बैज, हर वर्शन का एक आइटम। खाली ऐरे भी एक मान्य जवाब है।
refreshedAtstring (ISO 8601) | nullTwitch के बैज को पिछली बार सफलतापूर्वक पढ़ने का समय (हर 5 मिनट), पहली बार पढ़ने से पहले null।
rateLimit{ limit, remaining, resetAt }इस कॉल के बाद इस रूट पर आपकी सीमा, जैसा ratelimit-* हेडर बताते हैं: हर विंडो में limit अनुरोध, remaining अब भी अनुमत, और resetAt, जब पूरी सीमा वापस मिलती है (ISO 8601)।

Badge

badges का एक आइटम: किसी ग्लोबल चैट बैज का एक वर्शन, जैसा Twitch अभी उसे सूची में दिखाता है।

फ़ील्डप्रकारविवरण
setId, versionIdstringबैज सेट और उसका वर्शन: दोनों मिलकर एक बैज की पहचान करते हैं (sub-gifter और 5)।
title, descriptionstringइसका नाम और Twitch का विवरण, अंग्रेज़ी में।
imageUrl1x, imageUrl2x, imageUrl4xstring (URL)18, 36 और 72 पिक्सेल पर इसकी तस्वीर।
clickAction, clickUrlstring | nullबैज पर क्लिक करने पर Twitch क्या करता है, और उसका लिंक; जब Twitch कुछ न दे तो null।
firstSeenAtstring (ISO 8601) | nullइस API ने बैज को पहली बार कब देखा। Twitch के हटाने के 7 दिन से ज़्यादा बाद लौटे बैज को नई तारीख मिलती है; उससे पहले लौटने पर वह अपनी पुरानी तारीख रखता है। पहली बार पढ़ने के समय पहले से मौजूद बैज के लिए null।
requirementBadgeRequirement | nullइसे पाने का तरीका; जब यह API नहीं जानता तो null।
BadgeRequirement के फ़ील्ड

BadgeRequirement

बैज पाने का तरीका: उसे देने वाले Drops अभियान से (DROPS), या किसी सब्सक्रिप्शन या देखने वाले बैज के बारे में Twitch के अपने विवरण से (TWITCH_DESCRIPTION)।

फ़ील्डप्रकारविवरण
source'DROPS' | 'TWITCH_DESCRIPTION'DROPS या TWITCH_DESCRIPTION।
watchTimeOnlybooleantrue ठीक तब, जब बस देखना काफ़ी हो: ऐसा DROPS अभियान जो देखने का समय मांगता है (requiredMinutes 0 से ज़्यादा) और कोई सब्सक्रिप्शन नहीं (requiredSubs 0)।
requiredMinutes, requiredSubsnumberदेखने के मिनट, और सब्सक्रिप्शन या गिफ़्ट, जो यह मांगता है।
gameId, gameNamestringगेम: उसका Twitch ID (पता न हो तो null) और उसका नाम।
channels, channelCountstring[] (≤ 5), numberइसे देने वाले पहले 5 चैनल (लॉगिन) और उनकी कुल संख्या; 0: उस गेम को स्ट्रीम करने वाला कोई भी चैनल।
startAt, endAtstring (ISO 8601) | nullअभियान कब चलता है; TWITCH_DESCRIPTION के लिए null। खत्म हुआ अभियान बना रहता है।
campaignId, campaignNamestring | nullDrops अभियान; TWITCH_DESCRIPTION के लिए null।
repeat{ everyHours, times } | nullसिर्फ़ DROPS: देखने का समय हर अवधि में दोबारा चाहिए, requiredMinutes एक अवधि का है, times और everyHours के साथ (3 दिन रोज़ 20 मिनट: times 3, everyHours 24); वरना null।
categories{ id, name }[] (≤ 50)सिर्फ़ DROPS: वे कैटेगरी जिनके लाइव चैनल गिने जाते हैं, उनमें से कोई भी (id और name, ज़्यादा से ज़्यादा 50); gameId और gameName पहली कैटेगरी हैं। वरना खाली।
collection{ chestSize, completeAll } | nullसिर्फ़ DROPS: बैज किसी इवेंट कलेक्शन, यानी अभियान, के इनामों में से एक है। chestSize: यह इतने इनामों वाले संदूक से निकलता है, हर संदूक से एक, कभी अपनी पसंद से नहीं (null: सीधे मिलता है)। completeAll: पूरा कलेक्शन पूरा करने पर मिलता है, सब्सक्रिप्शन समेत। वरना null।
evolvesFrom{ setId, versionId } | nullसिर्फ़ DROPS: वह बैज जिसे देखने से पहले चैट में लगाना ज़रूरी है, इस सूची में उसके setId और versionId से: Pokémon के इवॉल्यूशन के लिए उसका पिछला स्टेज चाहिए (Pikachu: Pichu)। वरना null, या जब पता न हो।

जवाब कोड

स्थितिविवरण
200ग्लोबल बैज। खाली सूची भी एक मान्य जवाब है।
304भेजे गए ETag के बाद से कुछ नहीं बदला: अपनी कॉपी रखें। मुफ़्त, आपकी सीमा में नहीं गिना जाता।
429RATE_LIMITED: Retry-After में दिए गए सेकंड तक रुकें।
429INVALID_API_KEY_RATE_LIMITED: कुंजी पहचानी नहीं गई और आपके IP पते की अनाम सीमा खत्म हो चुकी है: कुंजी ठीक करें।
503SERVICE_UNAVAILABLE: अभी कोई सूची लोड नहीं हुई (API के दोबारा शुरू होने के ठीक बाद): Retry-After के बाद फिर से कोशिश करें। मुफ़्त, आपकी सीमा में नहीं गिना जाता।
अनुरोध का उदाहरण
curl https://drops.sunkwi.com/api/twitch/badges
प्रीव्यू लोड हो रहा है…

अनुरोध सीमाएं

हर रूट का अपना काउंटर है: /drops को कॉल करने से /rewards या /badges का कोटा कभी खर्च नहीं होता। अभियान मिनट में एक बार और बैज हर 5 मिनट में बदलते हैं, इसलिए इससे तेज़ पोलिंग से कुछ नया नहीं मिलता।

कॉलरप्रति रूट सीमागिनती का आधार
अनामहर 5 मिनट में 1 अनुरोधIP पता
API कुंजी के साथडिफ़ॉल्ट रूप से 1 अनुरोध प्रति मिनट, अनुरोध पर बढ़ाई जा सकती हैAPI कुंजी

जवाब हेडर

API जो हेडर पढ़ता और भेजता है।

हेडरदिशाविवरण
x-last-updated-atresponseTwitch को आखिरी बार सफलतापूर्वक पढ़ने का समय: /drops और /rewards के लिए स्कैन, /badges के लिए बैज।
x-refresh-interval-secondsresponseTwitch को दो बार पढ़ने के बीच के सेकंड: इससे ज़्यादा बार पूछने पर वही डेटा मिलता है (/drops और /rewards के लिए 60, /badges के लिए 300)।
ratelimit-limitresponseइस रूट के लिए, विंडो में अनुमत अनुरोध।
ratelimit-remainingresponseमौजूदा विंडो में बचे अनुरोध।
ratelimit-resetresponseफिर से अनुरोध की अनुमति मिलने तक के सेकंड।
ratelimit-policyresponseनीति, <सीमा>;w=<सेकंड में अवधि> के रूप में।
retry-afterresponse429 या 503 जवाब मिलने पर, फिर से कोशिश करने से पहले रुकने के सेकंड।
x-api-keyrequestआपकी API कुंजी: हर रूट पर वैकल्पिक।
x-api-key-statusresponseinvalid जब भेजी गई कुंजी अनजान, रद्द या बंद की गई हो: कॉल अनाम गिनी गई, आपके IP पते की सीमा में।
etagresponseइस जवाब का टैग। इसे If-None-Match में वापस भेजें: जब तक डेटा नहीं बदलता, जवाब 304 होता है, जो आपकी सीमा में नहीं गिना जाता।
if-none-matchrequestआपके पिछले जवाब का ETag, वैकल्पिक: बिना बदलाव की सूची 304 Not Modified लौटाती है, मुफ़्त।
5 मिनट के अंदर दूसरी अनाम कॉल
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" }

त्रुटियां

त्रुटियां एक स्थिर कोड के साथ JSON बॉडी लौटाती हैं: { "code": "RATE_LIMITED" }। कोड कभी नहीं बदलते: संदेश पर नहीं, code पर निर्भर रहें।

स्थितिकोडविवरण
429RATE_LIMITEDइस रूट पर बहुत ज़्यादा अनुरोध: Retry-After में दिए गए सेकंड तक रुकें।
429INVALID_API_KEY_RATE_LIMITEDबहुत ज़्यादा अनुरोध, और X-API-Key हेडर में अनजान, रद्द या बंद की गई कुंजी है: कॉल अनाम गिनी गई। कुंजी ठीक करें, या Retry-After में दिए गए सेकंड तक रुकें।
503SERVICE_UNAVAILABLEअभी कोई सूची लोड नहीं हुई है (API के दोबारा शुरू होने के ठीक बाद)। कुछ खर्च नहीं होता: Retry-After में दिए गए सेकंड के बाद फिर से कोशिश करें।
404NOT_FOUNDयह रूट मौजूद नहीं है।
500INTERNAL_SERVER_ERRORसर्वर में गड़बड़ी हुई: बाद में फिर से कोशिश करें।
त्रुटि का उदाहरण
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }

साइट से API तक

इस साइट का हर पेज इन्हीं रूट को पढ़ता है। यहां बताया गया है कि पेज पर दिखने वाली चीज़ें जवाब में कहां हैं।

पेजरूटजवाब में कहां
Drops/drops/dropsgames: हर गेम का एक आइटम, उसके अभियान rewards में। ग्रिड व्यू हर अभियान के startAt और endAt से बनता है।
गेम पेज/drops/<game>/dropsgames का एक आइटम, gameId से मिलान किया गया। हर अभियान games[i].rewards[j] है; उसके इनाम timeBasedDrops के benefitEdges हैं, requiredMinutesWatched के साथ।
इनाम/rewards/rewardscampaigns: हर इनाम अभियान का एक आइटम, उसके इनाम rewards में और उसकी शर्तें unlockRequirements में।
इनाम अभियान पेज/rewards/<campaign>/rewardscampaigns का एक आइटम, id से मिलान किया गया; उसके इनाम rewards में हैं।
बैज/badges/badgesbadges: हर आइटम, और जिनमें requirement है वे पहले, उन्हें पाने के तरीके के साथ। ग्रिड व्यू हर बैज के requirement.startAt और requirement.endAt से बनता है।
बैज पेज/badges/<badge>/badgesbadges का एक आइटम, setId और versionId से मिलान किया गया; “इसे कैसे पाएं” उसका requirement है।