คำนิยาม
ฮาร์ทบีท
ข้อความเป็นช่วงๆที่ช่วยรักษาการเชื่อมต่อ WebSocket ให้ยังคงใช้งานได้
Definition
สัญญาณฮาร์ทบีทของ WebSocket คือข้อความที่ส่งเป็นช่วงๆ ผ่านการเชื่อมต่อ WebSocket เพื่อยืนยันว่าการเชื่อมต่อยังคงใช้งานได้ ใน WebSocket ตลาดของ Polymarket เซิร์ฟเวอร์คาดหวัง PING ทุก ๆ 10 วินาที; หากขาด heartbeat อาจทำให้เซิร์ฟเวอร์หรือตัวกลางตัดการเชื่อมต่อได้
In context
เมื่อคุณสมัครรับฟีดตลาดของ Polymarket (wss://ws-subscriptions-clob.polymarket.com/ws/market) วงจรการเชื่อมต่อจะขึ้นกับ heartbeat เป็นประจำ เซิร์ฟเวอร์จะส่งเหตุการณ์ตลาด (best_bid_ask, last_trade_price, price_change, tick_size_change) และคาดหวัง PING ประมาณทุก 10 วินาทีเพื่อหลีกเลี่ยงการหมดเวลา การใช้งานควรตอบสนองต่อเฟรม PING/PONG ขาเข้าและส่ง PING เป็นช่วง ๆ จากฝั่งไคลเอนต์ด้วย หากช่องทางขนส่งหรือตัวกลางอาจปิดซ็อกเก็ตที่อยู่เฉย
Practical notes
- ใช้ตัวจับเวลาที่สั้นกว่า 10 วินาทีเล็กน้อย (เช่น 9–10 วินาที) เพื่อทนต่อความหน่วงของเครือข่ายและดีเลย์การประมวลผล
- จัดการกรณี heartbeat หายด้วยการพยายามเชื่อมต่อใหม่อย่างสะอาดและสมัครรับเครื่องมือของคุณอีกครั้ง ตรรกะการเชื่อมต่อใหม่ควรรวมการหน่วงเพิ่มขึ้น (backoff) เพื่อหลีกเลี่ยงการเกิดฝูงชนพร้อมกัน
- เคารพขีดจำกัด 500-instrument-per-connection เมื่อสมัครรับซ้ำ; WebSocket จะปฏิเสธคำขอสมัครรับที่ใหญ่เกินไป
See also
- /glossary/market-channel