← เอกสารอ้างอิง API
เปรียบเทียบผู้ให้บริการ

การให้สิทธิ์ LINE

LINE รองรับเฉพาะการเข้าสู่ระบบด้วย QR เท่านั้น URL ของ QR และ PIN จะไม่กลับมาในการตอบกลับแบบ sync แต่ส่งผ่าน webhook แบบ async แล้วเปิดผ่าน resource session

qrcode

การเข้าสู่ระบบ LINE ด้วย QR: QR URL และ PIN จะมาถึงแบบ async รับผ่าน event account.auth.required หรืออ่านผ่าน /auth/session

  1. 1. POST /v1/accounts โดยใช้ provider=line, auth_mode=qrcode อาจระบุ metadata.device_login_type (เช่น DESKTOPMAC)
  2. 2. POST /v1/accounts/{account_id}/auth/qr/start เพื่อให้ LINE provider เริ่มเซสชันเข้าสู่ระบบ
  3. 3. รอ event account.auth.required บน webhook และสามารถอ่าน QR URL กับ PIN ผ่าน /auth/session ได้ด้วย
  4. 4. GET /v1/accounts/{account_id}/auth/session เพื่อดึง URL ของ QR และ PIN มาแสดง พร้อม poll qr/check
  5. 5. เมื่อรับ account.auth.succeeded ระบบจะเติมตัวระบุบัญชีให้อัตโนมัติ จากนั้น POST /v1/accounts/{account_id}/runtime/start เพื่อออนไลน์
  • metadata.device_login_type — รหัสอุปกรณ์เสริม เช่น DESKTOPMAC, DESKTOPWIN จะถูกส่งต่อให้ LINE provider เมื่อเริ่มเซสชัน QR

หมายเหตุ

  • QR URL และ PIN จะไม่กลับมาในการตอบกลับ qr/start แต่จะมาภายหลังผ่าน event account.auth.required ให้ poll GET /auth/session หรือใช้ webhook เพื่อดึง
  • PIN ใช้สำหรับฝั่งผู้เรียกแสดงเท่านั้น — ไม่ได้ส่งกลับ LINE แสดงไว้ข้าง QR เพื่อให้ผู้ใช้ยืนยันว่าสแกนเครื่องที่ถูก
  • เมื่อ account.auth.succeeded มาถึง ระบบจะเติมตัวระบุบัญชีให้อัตโนมัติ และ event จะมีฟิลด์โปรไฟล์มาตรฐาน