ข้อมูลอ้างอิง Twitch Drops API
API แบบ JSON ฟรีที่แสดงแคมเปญ 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 ในแดชบอร์ด แล้วสร้างคีย์ที่ตั้งชื่อตามบอทหรือเว็บไซต์ของคุณ
- คัดลอกคีย์เมื่อแสดงขึ้นมา (แสดงเพียงครั้งเดียว) แล้วส่งในเฮดเดอร์
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