ต่อบอทหรือระบบของคุณเข้ากับทิป
Tipjai เป็นระบบไม่ถือเงิน (non-custodial) เงินวิ่งจากผู้ให้ทิปถึงครีเอเตอร์โดยตรง เหตุการณ์ในระบบจึงเกี่ยวกับวงจรของทิป (รอชำระ ยืนยัน แจ้งเตือนบนสตรีม) ไม่ใช่การเคลื่อนเงิน
เมื่อเชื่อม Paynoi (ของเสริม) ธนาคารของคุณยืนยันการรับเงินแล้วยิงเข้ามาที่ Webhook URL เฉพาะของคุณ Tipjai จะจับคู่กับทิปที่รอชำระ ยืนยัน และยิงการ์ดแจ้งเตือนให้อัตโนมัติ
POST https://tipjai.com/api/paynoi/<your-secret>
ตั้งค่าได้ใน Studio หน้าช่องทางรับเงิน ส่วนยืนยันอัตโนมัติ Webhook URL ของคุณเป็นความลับเฉพาะตัว อย่าเปิดเผย ระบบยืนยันด้วยการจับคู่ทิปจริงและกันส่งซ้ำ
ฝั่งคุณไม่ต้องเขียนโค้ด เพียงวาง Webhook URL ในแดชบอร์ด Paynoi
หน้าจอ overlay ทุกตัวคือ Browser Source สำหรับ OBS เปิดพื้นหลังโปร่งใสให้เอง วางลิงก์แล้วใช้ได้ทันที
/overlay/<token> การ์ดแจ้งเตือนทิป /overlay/<token>/<widget> leaderboard, goal, ticker, chat /countdown?...&overlay=1 นับถอยหลัง / เดบิวต์
REST แบบอ่านอย่างเดียว เปิด CORS ทุก origin คืนเฉพาะข้อมูลสาธารณะ (เหมือนที่เห็นบนหน้าโปรไฟล์) ไม่มีข้อมูลการเงินหรือส่วนตัว และไม่ต้องใช้คีย์ จำกัด 60 คำขอต่อไอพีต่อนาที
GET /api/v1/creator/<username> GET /api/v1/creator/<username>/leaderboard?period=month&limit=10 GET /api/v1/stats
ตัวอย่าง:
curl https://tipjai.com/api/v1/creator/<username>
{
"username": "...", "display_name": "...", "verified": true,
"category": "vtuber", "total_received": 1850, "supporters": 9,
"socials": { ... }, "tip_url": "https://tipjai.com/..."
}total_received เป็น null ถ้าครีเอเตอร์เลือกซ่อนยอด และ response นี้ไม่แคชเพื่อให้การตั้งค่าความเป็นส่วนตัวมีผลทันที เหมาะกับ overlay บอท หรือแดชบอร์ดของคุณเอง Remote MCP ที่หน้านักพัฒนา docs.tipjai.com/developers เมื่อไม่ส่งคีย์ มีเครื่องมือของหน้า Tipjai Link กับเครื่องมือค้นหาครีเอเตอร์จากชื่อเท่านั้น ข้อมูลข้างบนนี้ต้องเรียกผ่าน REST ส่วนข้อมูลส่วนตัวของคุณใช้คีย์ API ดูหัวข้อถัดไป
ลองยิงได้จากกล่องทดลองด้านบนของหน้านี้
ใช้คีย์ API ส่วนตัวจากด้านบน ส่งในส่วนหัว Authorization ทุกคำขอ แต่ละคีย์ทำได้เฉพาะสิทธิ์ที่เลือกไว้ ถ้าไม่มีสิทธิ์จะได้ 403 คีย์ผิดหรือถูกยกเลิกได้ 401 จำกัด 120 คำขอต่อคีย์ต่อนาที (เกินได้ 429 พร้อม Retry-After) ใช้จากเซิร์ฟเวอร์หรือบอทของคุณเท่านั้น อย่าใส่คีย์ในหน้าเว็บ
Authorization: Bearer tj_live_... GET /api/v1/me คีย์นี้เป็นของใคร มีสิทธิ์อะไร GET /api/v1/me/tips?limit=25 tips:read GET /api/v1/me/stats?from=2026-10-01&to=2026-10-21 stats:read GET /api/v1/me/export?from=2026-10-01&to=2026-10-31 export:read (CSV)
นับเฉพาะเงินที่หน้ารายรับใน Studio นับ คือทิปที่ยืนยันแล้ว ไม่ใช่ทิปทดสอบ (verification เป็น verified, structural หรือ creator_confirmed) วันอิงเวลาไทย tips เรียงจากล่าสุด กรองด้วย from, to, min_amount, max_amount และหน้าถัดไปส่ง cursor ที่ได้จาก next_cursor
{
"object": "list",
"data": [{
"id": "<uuid>", "amount": 100, "currency": "THB",
"supporter": "มะลิ", "message": "สู้ ๆ", "verification": "verified",
"payment_method": "promptpay", "gift": null,
"settled_at": "2026-10-21T13:00:00.123456+00:00", "created_at": "..."
}],
"next_cursor": "MjAyNi0xMC0yMVQxMzowMDow..."
}stats ให้ยอดรวมรายวันและผลรวมของช่วง (สูงสุด 366 วัน ค่าเริ่มต้น 30 วันล่าสุด) export ให้ไฟล์ CSV คอลัมน์เดียวกับปุ่มดาวน์โหลดใน Studio สูงสุด 20,000 แถวต่อไฟล์ และ 10 ไฟล์ต่อนาที
ให้เครื่องมือของคุณส่งอีเวนต์จากแพลตฟอร์มอื่น เช่น ของขวัญบน YouTube หรือคนกดติดตามบน Kick ขึ้นกล่องแจ้งเตือนเดียวกับทิป ใช้สวิตช์ชุดเดียวกับแจ้งเตือน TikTok ในหน้า แจ้งเตือนและวิดเจ็ต หัวข้อ แจ้งเตือนจาก TikTok LIVE คือต้องเปิดแจ้งเตือนไว้ และถ้าจะส่งคนกดติดตามหรือคนแชร์ ต้องเปิด แสดงคนกดติดตาม หรือ แสดงคนแชร์ไลฟ์ ด้วย (สองอย่างนี้ปิดอยู่ตั้งแต่แรก) ต้องใช้สิทธิ์ events:write
POST /api/v1/me/events
Authorization: Bearer tj_live_...
Idempotency-Key: yt-gift-8812
{ "type": "gift", "name": "มะลิ", "source": "YouTube",
"gift": { "name": "Super Sticker", "count": 1 } }
201 { "id": "<uuid>", "object": "event", "type": "gift",
"shown": true, "reason": null, "counted_as_money": false, ... }type เป็น gift, follow, share หรือ sub อีเวนต์ไม่ใช่เงินเสมอ ไม่เข้ายอดรวม เป้า อันดับ นาฬิกาซับบาธอน รายรับ ภาษี หรือ webhook และถ้าส่ง amount, value, price หรือ currency มา จะถูกปฏิเสธ (422)
คำตอบบอกว่าขึ้นจอหรือไม่ shown เป็น true เมื่อส่งไปที่จอแจ้งเตือนของคุณแล้ว ถ้าเป็น false ดู reason: platform_alerts_off คือปิดแจ้งเตือนไว้ hidden_by_settings คือประเภทนั้นยังปิดอยู่ เช่น คนกดติดตาม overlay_unreachable คือส่งไปที่จอไม่สำเร็จ
Idempotency-Key จำเป็น ส่งซ้ำด้วยคีย์เดิมภายใน 7 วันจะได้ผลลัพธ์แรกกลับมา (ส่วนหัว Idempotent-Replayed: true) และไม่ขึ้นจอซ้ำ ใช้คีย์เดิมกับอีเวนต์อื่นได้ 422 สูงสุด 60 อีเวนต์ต่อนาที
คุมนาฬิกาบนสตรีมเหมือนปุ่มใน Studio สูงสุด 30 คำสั่งต่อนาที ต้องใช้สิทธิ์ timer:write
POST /api/v1/me/timer
{ "action": "add", "seconds": 300 } หรือ subtract
{ "action": "pause" } หรือ resumeRemote MCP ที่ /api/mcp เมื่อส่งคีย์ API มาด้วยจะมีเครื่องมือของคุณเพิ่ม: tipjai_my_tips (tips:read), tipjai_my_stats (stats:read) และ tipjai_timer_control (timer:write) เครื่องมือที่คีย์ไม่มีสิทธิ์จะตอบเป็นข้อผิดพลาด ไม่ส่งคีย์ก็ใช้เครื่องมือสาธารณะของ Tipjai Link ได้เหมือนเดิม
{
"mcpServers": {
"tipjai": {
"type": "http",
"url": "https://tipjai.com/api/mcp",
"headers": { "Authorization": "Bearer tj_live_..." }
}
}
}ทิปที่ยืนยันแล้วส่งเข้าห้อง Discord หรือแชต Telegram ของคุณได้ด้วย (ตั้งค่าที่หน้า เชื่อมต่อและแจ้งเตือน มีปุ่มส่งทดสอบ)
ต่อ Catch Hook ของ Zapier, Make หรือ IFTTT จากหน้า เชื่อมต่อและแจ้งเตือน ใน Studio เมื่อทิปจริงยืนยันแล้ว Tipjai จะส่ง event ที่มีลายเซ็นและลองซ้ำอัตโนมัติหากปลายทางล่ม โดยไม่แตะสถานะเงิน
POST <your catch-hook> Idempotency-Key: <delivery UUID> X-Tipjai-Event: tip.confirmed X-Tipjai-Timestamp: 1787936000 X-Tipjai-Signature: v1=<HMAC-SHA256>
{
"id": "<delivery UUID>",
"event": "tip.confirmed",
"schema_version": 1,
"created_at": "2026-09-22T13:00:00Z",
"data": {
"tip_id": "<uuid>", "supporter": "มะลิ", "amount": 60, "currency": "THB",
"message": "ช้างสามตัว", "verification": "verified",
"gift": { "id": "elephant", "name": "ช้าง", "qty": 3 }
}
}gift เป็น null เมื่อทิปไม่มีของขวัญ ฟิลด์ใหม่จะถูกเพิ่มโดยไม่เปลี่ยน schema_version ปลายทางจึงควรอ่านเฉพาะฟิลด์ที่ใช้
คำนวณ HMAC-SHA256 จากข้อความ timestamp บวกจุด บวก raw JSON body ด้วย signing secret ที่แสดงในการ์ดเชื่อมต่ออัตโนมัติ หน้าเชื่อมต่อและแจ้งเตือน แล้วเทียบแบบ constant-time ปฏิเสธ timestamp เก่าเกิน 5 นาที และ dedupe ด้วย Idempotency-Key
expected = HMAC_SHA256(secret, timestamp + "." + rawBody)
valid = timingSafeEqual("v1=" + expected, xTipjaiSignature)ระบบลองส่งซ้ำแบบ exponential backoff สูงสุด 10 ครั้งในเวลาประมาณ 2 ชั่วโมง (รอ 15 วินาทีแล้วเพิ่มเป็นสองเท่าทุกครั้ง ห่างกันไม่เกิน 1 ชั่วโมง) จากนั้นเป็น dead-letter ส่งรายการค้างอีกครั้งได้จากการ์ดเชื่อมต่ออัตโนมัติ หน้าเชื่อมต่อและแจ้งเตือน ภายใน 7 วัน รายการที่เก่ากว่า 1 วันจะลองส่งได้อีกครั้งเดียว สถานะ queued, retrying, delivered และ dead-letter ดูได้จากการ์ดเดียวกัน