Αναφορά του Twitch Drops API
Ένα δωρεάν JSON API με κάθε ενεργή καμπάνια Twitch Drops και ανταμοιβών, που ανανεώνεται κάθε λεπτό, και με τα καθολικά σήματα συνομιλίας του Twitch. Καλέστε το ανώνυμα ή με ένα δωρεάν κλειδί API για υψηλότερο όριο.
Δοκιμάστε το
Διαδρομές
Κάθε διαδρομή απαντά με JSON σε ένα αίτημα GET και τα προγράμματα περιήγησης οποιουδήποτε ιστότοπου μπορούν να καλέσουν το API (CORS). Ούτε το /drops, ούτε το /rewards, ούτε το /badges απαιτούν εγγραφή· ένα δωρεάν κλειδί API ανεβάζει το όριο σε καθένα από αυτά.
Και οι τρεις διαδρομές απαντούν με τον ίδιο τρόπο: η λίστα, η ώρα της τελευταίας ανάγνωσης του Twitch (refreshedAt) και το όριο αιτημάτων σας (rateLimit).
Έλεγχος ταυτότητας
Η ανάγνωση των /drops, /rewards και /badges δεν απαιτεί λογαριασμό ούτε κλειδί. Οι ανώνυμες κλήσεις μετρώνται ανά διεύθυνση IP: 1 αίτημα κάθε 5 λεπ. σε κάθε διαδρομή.
Τα κλειδιά είναι δωρεάν: συνδεθείτε με Discord, Twitch ή GitHub, δημιουργήστε ένα στον πίνακα ελέγχου και στείλτε το στην κεφαλίδα X-API-Key. Ένα κλειδί αυξάνει το όριό σας σε 1 αίτημα ανά λεπτό από προεπιλογή, με δυνατότητα αύξησης κατόπιν αιτήματος, και δείχνει την κίνησή σας.
Κρατήστε το κλειδί στον διακομιστή σας: όποιος το διαβάσει μπορεί να καταναλώσει το όριό σας. Διαβάστε το από μια μεταβλητή περιβάλλοντος αντί να το γράφετε στον κώδικά σας.
Κεφαλίδα αιτήματος
# 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
Ένα κλειδί είναι δωρεάν. Αυξάνει το όριό σας από 1 αίτημα κάθε 5 λεπ. σε 1 αίτημα ανά λεπτό σε κάθε διαδρομή, και ο πίνακας ελέγχου σας δείχνει την κίνησή του.
- Συνδεθείτε με Discord, Twitch ή GitHub: χωρίς κωδικό πρόσβασης, χωρίς φόρμα.
- Ανοίξτε τα Κλειδιά API στον πίνακα ελέγχου σας και δημιουργήστε ένα κλειδί με το όνομα του bot ή του ιστότοπού σας.
- Αντιγράψτε το κλειδί όταν εμφανιστεί (μόνο μία φορά) και στείλτε το στην κεφαλίδα
X-API-Key, από τον διακομιστή σας.
Λήψη καμπανιών Drops
Κάθε ενεργή καμπάνια Drops, ομαδοποιημένη ανά παιχνίδι: ένα στοιχείο του games ανά παιχνίδι, με τις καμπάνιες του στο rewards, μαζί με την ώρα της τελευταίας σάρωσης του Twitch και το όριο αιτημάτων σας.
Σώμα απάντησης
Game
Πεδία DropCampaign, TimeBasedDrop και Benefit
DropCampaign
TimeBasedDrop
Benefit
Τα ονόματα των πεδίων προέρχονται από το Twitch και δεν αλλάζουν ποτέ: μπορεί να εμφανιστούν νέα πεδία, τα υπάρχοντα παραμένουν.
Κωδικοί απάντησης
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" }}Λήψη καμπανιών ανταμοιβών
Κάθε ενεργή καμπάνια ανταμοιβών (εκδηλώσεις σε όλο το Twitch, σήματα συνομιλίας, ανταμοιβές συνεργατών) στο campaigns, μαζί με την ώρα της τελευταίας σάρωσης του Twitch και το όριο αιτημάτων σας.
Σώμα απάντησης
RewardCampaign
Πεδία ανταμοιβών
RewardGroup
Reward
Κωδικοί απάντησης
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" }}Λήψη σημάτων συνομιλίας
Τα καθολικά σήματα συνομιλίας του Twitch στο badges, ένα στοιχείο ανά έκδοση, το καθένα με τον τρόπο απόκτησης όταν το API τον γνωρίζει (requirement), μαζί με την ώρα της τελευταίας ανάγνωσης των σημάτων του Twitch και το όριο αιτημάτων σας.
Σώμα απάντησης
Badge
Πεδία BadgeRequirement
BadgeRequirement
Για προγράμματα συλλογής Drops: κρατήστε τα σήματα των οποίων το requirement.watchTimeOnly είναι true. Προέρχονται από καμπάνια Drops που δίνει το σήμα μόνο για χρόνο παρακολούθησης, ποτέ για συνδρομή. Ελέγξτε επίσης τα startAt και endAt: μια καμπάνια που έληξε παραμένει στη λίστα.
Ορισμένα σήματα ζητούν περισσότερα: με repeat, παρακολουθήστε ξανά requiredMinutes σε κάθε περίοδο, times φορές, πριν από το endAt· μετράει οποιοδήποτε ζωντανό κανάλι των categories· με collection, ένα σεντούκι μπορεί να δώσει άλλο σήμα από αυτό που θέλετε (chestSize), και το completeAll απαιτεί όλη τη συλλογή, μαζί με τις συνδρομές. Με evolvesFrom, επιλέξτε αυτό το σήμα πριν παρακολουθήσετε.
Κωδικοί απάντησης
curl https://drops.sunkwi.com/api/twitch/badgesΌρια αιτημάτων
Κάθε διαδρομή έχει δικό της μετρητή: μια κλήση στο /drops δεν καταναλώνει ποτέ το όριο του /rewards ή του /badges. Οι καμπάνιες αλλάζουν μία φορά το λεπτό και τα σήματα κάθε 5 λεπτά, οπότε οι συχνότερες κλήσεις δεν φέρνουν τίποτα νέο.
Κεφαλίδες απάντησης
Μια κλήση που απορρίφθηκε (429) μετράει κι αυτή: περιμένετε το 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" }Σφάλματα
Τα σφάλματα επιστρέφουν σώμα JSON με σταθερό κωδικό: { "code": "RATE_LIMITED" }. Οι κωδικοί δεν αλλάζουν ποτέ: βασιστείτε στο code, όχι στο κείμενο ενός μηνύματος.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Από τον ιστότοπο στο API
Κάθε σελίδα αυτού του ιστότοπου διαβάζει αυτές τις ίδιες διαδρομές. Εδώ φαίνεται πού βρίσκεται στις απαντήσεις ό,τι δείχνει μια σελίδα.
Η διεύθυνση μιας σελίδας παιχνιδιού προκύπτει από το όνομα του παιχνιδιού (Rocket League → /drops/rocket-league). Είναι διεύθυνση αυτού του ιστότοπου, όχι πεδίο του API: αντιστοιχίστε τα παιχνίδια με βάση το gameId.