สำหรับนักพัฒนา

อ่านตรงนี้ก่อน

หน้านี้ไม่ใช่เอกสาร API เพราะ API สาธารณะสำหรับนักพัฒนาภายนอกของ HELOS ยังไม่เปิด เราเลือกไม่เผยแพร่รายการปลายทาง (endpoint) คีย์ หรือตัวอย่างการเรียกใช้งาน จนกว่าสัญญาการใช้งานจะนิ่งพอจะรับประกันความเข้ากันได้ย้อนหลัง และจนกว่าจะมีกระบวนการตรวจสอบสิทธิ์และขอความยินยอมที่รับผิดชอบได้จริง สิ่งที่หน้านี้ให้คือภาพสถานะตรงไปตรงมา เพื่อให้คุณตัดสินใจได้ว่าจะลงแรงตอนนี้หรือรอ

ถ้าคุณเจอปลายทางภายในของเราจากการดักดูทราฟฟิก อย่านำไปใช้ในผลิตภัณฑ์จริง มันไม่มีการรับประกันความเสถียร และการเรียกใช้โดยไม่ได้รับอนุญาตขัดกับเงื่อนไขการให้บริการ

---

สถานะปัจจุบัน

สิ่งที่นักพัฒนามักถาม	สถานะ	หมายเหตุ
Public API (REST / GraphQL)	ยังไม่เปิด	ไม่มีคีย์และเอกสารสาธารณะ
Bot platform	ยังไม่เปิด	ไม่มีบัญชีบอทสำหรับภายนอก
Webhooks	ยังไม่เปิด	ไม่มีการส่งเหตุการณ์ออกภายนอก
Sign in with HELOS (OAuth)	ยังไม่เปิด	อยู่ในแผนระยะกลาง
Deep links แบบสาธารณะ	อยู่ระหว่างพัฒนา	สคีมายังไม่นิ่ง
Browser Sync (บุ๊กมาร์กเท่านั้น)	Beta	จับคู่แบบสมัครใจ
GugarHices Browser	Beta	เบราว์เซอร์เดสก์ท็อปเขียนด้วย Rust
GugarHices Search	Experimental	คุณภาพผลค้นหายังไม่นิ่ง
การส่งแอปเข้าสโตร์ในแอป	ยังไม่เปิด	มีเฉพาะแอปของ GugarHices
HELOS Desktop Launcher (.exe)	อยู่ระหว่างพัฒนา	ยังไม่เปิดให้ดาวน์โหลด
กระเป๋าเงินและการชำระเงิน	ยังไม่เปิด	ไม่มีการเชื่อมต่อสำหรับนักพัฒนา

ข้อมูลและโครงสร้างพื้นฐาน

สรุปคร่าว ๆ ว่าฝั่งระบบใช้เครื่องมืออะไรบ้าง สำหรับคนที่อยากรู้ภาพรวม ไม่ได้เปิดสิทธิ์เข้าฐานข้อมูลให้ภายนอก

หัวข้อ	สิ่งที่ใช้	หมายเหตุ
ฐานข้อมูลหลัก	PostgreSQL 16	เก็บข้อมูลหลักของแอป เช่น บัญชี แชท กิจกรรม ฟีด
แคช / งานสั้น / เรตลิมิต	Redis 7	ช่วยเรื่องเซสชันชั่วคราวและจำกัดการเรียกซ้ำ
สื่อ (รูป วิดีโอ ไฟล์)	ที่เก็บไฟล์บนเซิร์ฟเวอร์แอป	ดึงผ่านระบบสื่อของ HELOS
การส่งข้อมูลระหว่างเครื่องกับเซิร์ฟเวอร์	HTTPS / TLS	เข้ารหัสระหว่างทางตามมาตรฐานเว็บทั่วไป
ข้อมูลอ่อนไหวและข้อความที่เก็บฝั่งเซิร์ฟเวอร์	AES-256-GCM	เข้ารหัสตอนเก็บในเซิร์ฟเวอร์ เพื่อลดความเสี่ยงหากมีคนเข้าถึงที่เก็บข้อมูล
End-to-end encryption (E2EE) แชท	รอบถัดไป	อยู่ในแผนอัปเดต / จะพิจารณาเมื่อผู้ใช้ต้องการชัดเจน
แอปมือถือ (แคชในเครื่อง)	SQLite บนอุปกรณ์	ช่วยให้แอปลื่นขึ้น ไม่ใช่ฐานข้อมูลกลาง
API แบ็กเอนด์หลัก	Go	ระบบหลังบ้านของ HeloSChat / HELOS
เสียง / เรียลไทม์	WebRTC + เซิร์ฟเวอร์สัญญาณของเรา	ยังปรับคุณภาพและขอบเขตฟีเจอร์ต่อเนื่อง
ค้นหา (GugarHices Search)	เอ็นจินของ GugarHices	Experimental — ผลค้นหายังไม่นิ่ง
พื้นที่โฮสต์	AWS (สิงคโปร์) + Caddy	ไม่เปิดการเข้าถึงฐานข้อมูลตรงจากภายนอก

เรื่องความเป็นส่วนตัวเพิ่มเติมดูที่ /privacy

แบรนด์และการอ้างอิงถึง HELOS

ถ้าคุณต้องเขียนถึง HELOS ในผลิตภัณฑ์ เอกสาร หรือสื่อของคุณ ขอให้ยึดหลักเหล่านี้

• เขียนชื่อผลิตภัณฑ์ว่า HELOS (ตัวพิมพ์ใหญ่ทั้งหมด) และชื่อเต็มของแอปว่า HeloSChat
• เขียนชื่อผู้พัฒนาว่า GugarHices คำเดียวติดกัน โดย G และ H เป็นตัวพิมพ์ใหญ่
• อ้างอิงสถานะให้ตรงตามตารางด้านบน โดยเฉพาะ Browser เป็น Beta และ Search เป็น Experimental
• อย่าใช้ชื่อหรือเครื่องหมายของเราในลักษณะที่ทำให้เข้าใจว่าเป็นความร่วมมือ การรับรอง หรือการเป็นพาร์ตเนอร์ หากยังไม่มีข้อตกลงเป็นลายลักษณ์อักษร
• ต้องการไฟล์โลโก้หรือแนวทางใช้แบรนด์ ติดต่อ [email protected]

Deep links

แนวคิดคือลิงก์เดียวควรพาผู้ใช้ไปยังจุดที่ถูกต้องในแอปได้ทันที เช่น โปรไฟล์ที่อ้างอิงด้วยรหัสสาธารณะ (HELO + อักขระ 4 ตัว) หรือหน้ากิจกรรมใน Helos Together ที่กดตอบรับต่อได้เลย

ตอนนี้สคีมาลิงก์ยังเปลี่ยนระหว่างการพัฒนา เราจึง ยังไม่ประกาศรูปแบบให้ใช้แบบผูกถาวร เพราะไม่อยากให้ใครฝังลิงก์ที่จะพังในอีกไม่กี่เดือน เมื่อรูปแบบนิ่งแล้ว เราจะเผยแพร่พร้อมนโยบายรองรับเวอร์ชันย้อนหลังที่ชัดเจน

Browser Sync: แนวคิดการจับคู่

Browser Sync เชื่อม GugarHices Browser บนเดสก์ท็อปกับบัญชี HELOS ของผู้ใช้ โดยมีหลักการดังนี้

1. ผู้ใช้เริ่มการจับคู่เองจากทั้งสองฝั่ง ไม่มีการเชื่อมอัตโนมัติจากการล็อกอินเพียงอย่างเดียว
2. สิ่งที่ซิงก์คือ บุ๊กมาร์กเท่านั้น
3. สิ่งที่ ไม่ ซิงก์คือ ประวัติการเข้าเว็บ แท็บที่เปิดอยู่ คุกกี้ และรหัสผ่านที่บันทึกไว้
4. ผู้ใช้ยกเลิกการจับคู่ได้ตลอดเวลา และจัดการเซสชันที่เชื่อมอยู่ได้จากแดชบอร์ดความเป็นส่วนตัว

ขอบเขตที่แคบนี้คือข้อจำกัดที่ตั้งใจให้เป็นเช่นนั้น ไม่ใช่ฟีเจอร์ที่ยังทำไม่เสร็จ

หลักการที่จะไม่เปลี่ยน แม้เปิด API แล้ว

• ไม่มีโฆษณา ไม่ขายข้อมูลส่วนบุคคล และไม่ติดตามพฤติกรรมข้ามแอป
• การเข้าถึงข้อมูลผู้ใช้ต้องผ่านความยินยอมที่เข้าใจได้และถอนได้
• ขอบเขตสิทธิ์ให้เท่าที่จำเป็น ไม่มีสิทธิ์แบบเหมารวม
• ผู้ใช้ต้องเพิกถอนการเชื่อมต่อของบุคคลที่สามได้เองจากแดชบอร์ดความเป็นส่วนตัว

แผนต่อไปอย่างซื่อตรง

เราไม่ให้กำหนดวันที่ยังยืนยันไม่ได้ ลำดับที่วางไว้คือทำสคีมา deep link ให้นิ่งและประกาศ ตามด้วยการยืนยันตัวตนและการขอความยินยอมสำหรับแอปภายนอก แล้วจึงเป็น API แบบอ่านข้อมูลกับกลุ่มทดสอบที่เชิญเข้าร่วม ส่วน API สาธารณะ กลไกเหตุการณ์ แพลตฟอร์มบอท และการรับแอปภายนอกเข้าสโตร์ อยู่หลังจากนั้น

ติดต่อทีม

ส่งอีเมลถึง [email protected] เพื่อขอรับแจ้งเตือนเมื่อโปรแกรมสำหรับนักพัฒนาเปิด บอกเราด้วยว่าคุณอยากสร้างอะไรและสร้างให้ผู้ใช้กลุ่มใด เราเก็บอีเมลเหล่านี้ไว้เพื่อการติดต่อเรื่องนี้เท่านั้น

เรื่องบัญชีและการใช้งานทั่วไป ติดต่อ [email protected] เรื่องข้อมูลส่วนบุคคล ติดต่อ [email protected]