Inbound Donations API
Inbound Donations API ให้คุณยิงรายการโดเนทที่เกิดขึ้นนอก EasyDonate เข้ามาในระบบ - รายการจะขึ้น alert บน overlay, อ่าน TTS, นับเข้า goal / leaderboard และเก็บลงประวัติ พฤติกรรมเหมือนโดเนทในระบบทุกอย่าง
ใช้ได้กับทุกกรณีที่มีการโดเนทเกิดขึ้นนอกระบบแล้วอยากให้ขึ้นจอไลฟ์ เช่น จาก แพลตฟอร์มหรือเว็บโดเนทที่คุณให้บริการ ระบบสมาชิก การซื้อสินค้า หรือ event พิเศษของคุณเอง
รายการที่สร้างผ่าน API นี้ไม่ใช่เงินจริงในระบบ EasyDonate - ไม่มี settlement และไม่มีผลต่อยอดถอน ภาษี หรือรายงานรายได้
สิ่งที่ต้องมี
ต้องใช้ token ที่มี scope write:donations - ใช้ได้ทั้ง API key ส่วนตัว
และ OAuth access token (ดู Authentication)
สร้างรายการโดเนท
POST https://api.easydonate.app/api/v1/donations
Authorization
bearer API key (ezdn_v1_) or OAuth access token (signed JWT)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://example.com/api/v1/donations" \ -H "Content-Type: application/json" \ -d '{ "donatorName": "string", "amount": 1 }'Request body
| Field | Type | จำเป็น | รายละเอียด |
|---|---|---|---|
donatorName | string | ใช่ | 1-50 ตัวอักษร ผ่านตัวกรองคำของสตรีมเมอร์ |
amount | number | ใช่ | มากกว่า 0 และไม่เกิน 1,000,000 |
currency | "THB" | - | รับเฉพาะ THB (ค่าเริ่มต้น) |
message | string | - | ไม่เกิน 255 ตัวอักษร ผ่านตัวกรองคำ + อ่าน TTS |
identifier | string | - | รหัสอ้างอิงผู้โดเนทฝั่งคุณ ใช้จัดกลุ่ม donor คนเดิม |
idempotencyKey | string | - | กันยิงซ้ำ - key เดิมจาก key/แอปเดิมจะได้รายการเดิมกลับ (duplicated: true) ไม่สร้างใหม่ |
skipAlert | boolean | - | true = บันทึกอย่างเดียว ไม่ขึ้น alert |
createdAt | ISO date | - | สำหรับ import ย้อนหลัง - รายการเก่ากว่า 5 นาทีจะไม่ขึ้น alert อัตโนมัติ |
Response
request message จะถูกส่งกลับในชื่อ donateMessage และระบบเติม id,
referenceNo, currency, createdAt และ duplicated ให้:
{
"statusCode": 200,
"data": {
"id": "01J...",
"referenceNo": "AB12CD",
"donatorName": "น้องใจดี",
"donateMessage": "สู้ ๆ นะครับ",
"amount": 100,
"currency": "THB",
"createdAt": "2026-07-11T12:00:00.000Z",
"duplicated": false
}
}ดู schema ฉบับเต็มได้ที่ API Reference
ข้อจำกัด
- Rate limit: 60 requests/นาที ต่อ credential (ดู Rate limits)
donatorNameและmessageผ่านตัวกรองคำเดียวกับโดเนทปกติ- alert เคารพยอดขั้นต่ำการแสดง alert ที่สตรีมเมอร์ตั้งไว้
- รายการเหล่านี้ไม่ใช่เงินในระบบ EasyDonate - ไม่มีผลต่อยอดถอน ภาษี หรือรายงานรายได้
สำหรับแพลตฟอร์ม (OAuth)
ถ้าคุณทำแพลตฟอร์มที่อยากส่ง event ให้สตรีมเมอร์หลายคน ให้ทำปุ่ม
"เชื่อมต่อ EasyDonate" ด้วย OAuth แล้วขอ scope
write:donations จากนั้นยิง endpoint เดียวกันนี้ด้วย access token
ของสตรีมเมอร์แต่ละคน