Sukson Messaging APIv1 Preview
สร้างบอทให้ห้องแชท Sukson
บอททำงานบนเซิร์ฟเวอร์ของคุณ Sukson ส่งข้อความที่เรียกบอทมาให้ แล้วบอทตอบกลับด้วย HTTP และ JSON ธรรมดา
Base URLhttps://api.sukson.dev/v1
curl -X POST \ https://api.sukson.dev/v1/chats/$CHAT_ID/messages \ -H "Authorization: Bearer $SUKSON_BOT_TOKEN" \ -H "Content-Type: application/json" \ -d '{"messages":[{"type":"text","text":"สวัสดีครับ"}]}'{ "messages": [ { "message_id": 812346, "chat_id": "0b6c3a52-5d0e-4c8e-9a51-6f1e7f6f2b10", "created": true } ]}ทำงานอย่างไร
บอทตัวแรกใน 3 ขั้น
สร้างบอท
สร้างบอทที่ member.sukson.com/bots แล้วเก็บ API token (ขึ้นต้นด้วย
วิธีสร้างบอทskbot_) ไว้ให้ดี ระบบแสดงให้ดูครั้งเดียวรับ webhook
webhook คือ URL บนเซิร์ฟเวอร์ของคุณ เมื่อมีคนเรียกบอท Sukson จะส่งข้อความนั้นมาที่ URL นี้เป็น JSON พร้อมลายเซ็น
รูปแบบ eventตอบกลับ
ตอบ
ส่งข้อความ{"reply": "..."}ได้ทันทีภายใน 10 วินาที หรือตอบ 200 ไปก่อน แล้วค่อยส่งข้อความผ่าน API
สิ่งที่ได้
ออกแบบให้ใช้ง่ายและตรวจสอบได้
Webhook มีลายเซ็น
ทุก event มีลายเซ็น HMAC-SHA256 ในหัว X-Sukson-Signature คุณจึงรู้ได้ว่ามาจาก Sukson จริง
Reply token
ตอบข้อความที่เรียกบอทได้ภายหลัง ด้วย reply_token ที่ใช้ได้ครั้งเดียวภายใน 60 วินาที
Rate limit ชัดเจน
120 คำขอต่อนาทีต่อบอท ทุกคำตอบบอกยอดที่เหลือในหัว X-RateLimit-*
เวอร์ชันอยู่ใน path
ทุก path ขึ้นต้นด้วยเวอร์ชัน เช่น /v1/me การเปลี่ยนที่ทำให้โค้ดเดิมพังจะมาในเวอร์ชันใหม่เท่านั้น
เอกสาร
ไปที่หัวข้อที่ต้องการ
ลองเรียก API ครั้งแรก
ใช้ token ของบอทเรียก GET /v1/me ถ้าได้ข้อมูลบอทกลับมา แปลว่าพร้อมแล้ว