ยกเลิกการยืนยันตัวตนใน UnifyPort โดยไม่ให้ QR เก่ากลับมาแสดง
หากต้องการยกเลิกขั้นตอนยืนยันตัวตนของ UnifyPort ให้เรียก POST /v1/accounts/{account_id}/auth/cancel พร้อม {} สำหรับผู้ให้บริการที่รองรับ การปิดหน้าต่าง QR เป็นเพียงการเปลี่ยนหน้าจอในแอป ควรซ่อนข้อมูลเข้าสู่ระบบเดิม ป้องกันคำตอบที่มาช้านำข้อมูลนั้นกลับมาแสดง ส่งคำขอยกเลิก แล้วอ่านสถานะก่อนเปิดให้เริ่มใหม่ หากคำขอหมดเวลา ผลลัพธ์ยังไม่ยืนยัน ไม่ได้แปลว่าการยกเลิกล้มเหลวแน่นอน
ประเด็นสำคัญ
- การยกเลิกที่ระบุในเอกสารรองรับ Telegram, WhatsApp และ TikTok อย่าอนุมานจากการรองรับ QR เพียงอย่างเดียว
- ค่า
cancelledในผลของคำสั่ง ไม่ใช่สิ่งเดียวกับสถานะยืนยันตัวตนปัจจุบันของบัญชี - จัดลำดับการเริ่ม ยกเลิก และส่งข้อมูลยืนยันตัวตนแยกตามบัญชี รวมถึงคำขอจากหลายแท็บ
- การยกเลิกไม่ใช่การลบบัญชี เปลี่ยนการเรียกเก็บเงิน หรือหลักฐานว่าเซสชันทั้งหมดในแพลตฟอร์มถูกเพิกถอน
เลือกการควบคุมให้ตรงกับเจตนา
| สิ่งที่ผู้ใช้ต้องการ | การดำเนินการที่เหมาะสม |
|---|---|
| ซ่อนหน้าล็อกอินชั่วคราว | ปิด UI และกำหนดให้ชัดว่าการยืนยันตัวตนจะดำเนินต่อหรือไม่ |
| เลิกการยืนยันตัวตนครั้งนี้ | ใช้คำสั่งยกเลิกที่รองรับ |
| พักการเชื่อมต่อที่ใช้งานอยู่ | หยุด runtime ไม่ใช่รีเซ็ตการยืนยันตัวตน |
| นำทรัพยากรบัญชีออกจาก UnifyPort | ใช้ขั้นตอนลบบัญชีแยกต่างหาก |
คู่มือหยุด runtime ตามแผนใช้กับบัญชีที่เชื่อมต่อแล้ว บทความนี้เน้นขั้นตอนยืนยันตัวตนที่ผู้ดูแลไม่ต้องการทำต่อให้เสร็จ
เอกสาร Cancel authenticationอธิบายการยกเลิกโฟลว์รหัสยืนยัน QR และการนำเข้าเซสชัน แต่รองรับเฉพาะ Telegram, WhatsApp และ TikTok แม้หน้าจอของคุณจะรวม LINE ไว้ด้วย ก็ไม่ควรเปิดปุ่มนี้ให้ LINE หรือ Zalo เพียงเพราะทั้งสองรองรับการล็อกอินด้วย QR
แยก QR หมดอายุออกจากการยกเลิกทั้งขั้นตอน
ข้อกำหนด QR login ของ Telegramอธิบายโทเค็นที่หมดอายุ การสร้าง QR ใหม่ และการยอมรับโทเค็นผ่านแอปที่ล็อกอินอยู่แล้ว ภาพ QR เก่าจึงไม่ใช่สถานะล็อกอินที่เก็บไว้ใช้ได้ถาวร แต่ข้อกำหนดนี้ไม่ได้กำหนดสัญญาการยกเลิกของ UnifyPort และไม่ได้รับรองว่าการปิดเบราว์เซอร์จะหยุดการยืนยันตัวตน
Get authentication stateของ UnifyPort ส่งคืน status, auth_fields, auth_payload, expires_at และ last_error ใช้สถานะและข้อมูลล่าสุดแทนภาพหน้าจอที่บันทึกไว้ อย่าเก็บ QR รหัสยืนยัน รหัสผ่าน หรือข้อมูลเซสชันในล็อกและระบบวิเคราะห์
สำหรับการเชื่อมต่อครั้งแรก อ่านคู่มือตั้งค่า Telegram ด้วยรหัสและ QR ส่วนที่เพิ่มในบทความนี้คือการควบคุมว่าความพยายามครั้งใดยังมีสิทธิ์อัปเดตหน้าจอหรือส่งคำขอต่อไป
จัดลำดับการยืนยันตัวตนของแต่ละบัญชี
ขั้นตอนต่อไปนี้เป็นคำแนะนำในการออกแบบแอป ไม่ใช่การรับประกันธุรกรรมแบบอะตอมมิกจากเซิร์ฟเวอร์:
- ผูกหน้าจอกับ workspace และ
account_idที่ตรวจสอบแล้ว และยืนยันสิทธิ์ของผู้ดูแลบัญชีรับส่งข้อความนั้น - ให้ backend มีตัวควบคุมการยืนยันตัวตนที่ใช้งานอยู่เพียงชุดเดียวต่อบัญชี ประสานงานกับแท็บและผู้ดูแลอื่น ไม่ใช่ป้องกันแค่การกดปุ่มซ้ำ
- เมื่อกดยกเลิก ให้ทำให้การลองครั้งเดิมในแอปใช้ต่อไม่ได้ ซ่อนข้อมูลลับ ปิดการส่งรหัสและรหัสผ่าน และหยุดตั้งเวลาวนตรวจใหม่
- เปลี่ยนเลขรุ่นของ UI เพื่อไม่ให้คำตอบของคำขอที่ส่งไปแล้วคืนหน้าจอเดิม
- ส่งคำขอยกเลิกผ่าน backend และยังไม่เปิดปุ่มเริ่มใหม่จนกว่าจะตรวจสอบผล
ตัวอย่างฝั่งเบราว์เซอร์นี้ทิ้งคำตอบการอ่านที่ล้าสมัย generation และ loginVisible เป็นตัวแปรของแอป ไม่ใช่ฟิลด์ของ UnifyPort:
let generation = 0;
let loginVisible = true;
async function refreshLogin(readAuth, render) {
const observedGeneration = generation;
const auth = await readAuth();
if (!loginVisible || observedGeneration !== generation) return;
render(auth);
}
function abandonLocalAttempt(clearSensitiveUi) {
loginVisible = false;
generation += 1;
clearSensitiveUi();
}
การป้องกันนี้ไม่สามารถยกเลิก HTTP ที่ส่งไปแล้ว ถอนการอนุมัติที่เกิดบนแพลตฟอร์ม หรือหยุดแท็บอื่นได้ ยังต้องประสานงานที่ backend และอ่านสถานะ เปิดตัวรับ webhook ไว้ตามเดิม เหตุการณ์ยืนยันตัวตนที่มาช้าควรทำให้ระบบตรวจสอบสถานะ ไม่ใช่เปิดหน้าต่าง QR เก่าขึ้นมาเอง
ส่งคำขอยกเลิก แล้วอ่านสถานะปัจจุบัน
คำขอต่อไปนี้เป็นตัวอย่างที่ยังไม่ได้รัน ให้กำหนดตัวแปรจากการตั้งค่า backend ที่ได้รับการปกป้องและบัญชีที่ผู้ดูแลตรวจสอบแล้ว:
curl -X POST \
"https://api.unifyport.ai/v1/accounts/${ACCOUNT_ID}/auth/cancel" \
-H "X-Api-Key: ${UNIFYPORT_API_KEY}" \
-H "Content-Type: application/json" \
-d '{}'
curl \
"https://api.unifyport.ai/v1/accounts/${ACCOUNT_ID}/auth" \
-H "X-Api-Key: ${UNIFYPORT_API_KEY}"
เอกสารยกเลิกแสดง HTTP 200 พร้อม data.status: "cancelled" ส่วนวงจรชีวิตบัญชีอธิบายว่าการละทิ้งโฟลว์ที่กำลังรอจะกลับเป็น pending_auth อย่าคัดลอกผลคำสั่งลงในทุกฟิลด์สถานะของบัญชี
| สิ่งที่สังเกตได้ | แนวทางจัดการ |
|---|---|
ยืนยันการยกเลิกแล้ว และสถานะเป็น pending_auth | ซ่อนข้อมูลเดิมต่อไป และให้ผู้ใช้เลือกเริ่มครั้งใหม่อย่างชัดเจน |
| คำขอหมดเวลาหรืออ่านคำตอบไม่ได้ | ระบุว่าผลยังไม่ยืนยัน อ่านสถานะก่อนเปลี่ยนแปลงอีกครั้ง |
| ยังรอข้อมูลจากผู้ใช้ | อย่าคืนหน้าจอเดิม ตรวจสอบต่อหรือส่งต่อผู้รับผิดชอบ แทนการเริ่มโฟลว์ซ้อน |
สถานะเป็น authorized | ถือเป็นข้อมูลปัจจุบัน อย่าระบุว่าออกจากระบบแล้วหรือยกเลิกซ้ำอัตโนมัติ |
หากการอนุมัติและการยกเลิกเกิดพร้อมกัน สัญญาสาธารณะไม่ได้รับประกันว่ารายการใดจะมีผลเหนือกว่าแบบอะตอมมิก เก็บข้อมูลวินิจฉัยที่ลบข้อมูลลับแล้ว และให้ผู้ดูแลตัดสินใจจากสถานะจริง อย่ารับรองว่าจะมี webhook ยกเลิกที่เอกสารไม่ได้ระบุ
เริ่มใหม่เมื่อมีการตัดสินใจใหม่เท่านั้น
เอกสารวงจรชีวิตระบุว่าการเริ่มยืนยันตัวตนด้วยรหัส QR หรือเซสชัน ขณะที่บัญชีเป็น authorized จะได้ 409 account_already_authorized นี่ไม่ใช่เหตุผลให้ยกเลิกบัญชีที่ทำงานปกติแล้วลองใหม่อัตโนมัติ ต้องยืนยันก่อนว่าต้องการการยืนยันตัวตนรอบใหม่จริงหรือไม่
สำหรับโฟลว์ที่กำลังรอและถูกละทิ้ง ให้ตรวจสอบผลยกเลิกก่อน แล้วสร้าง UI รุ่นใหม่ เรียกขั้นตอนเริ่มตามโหมดที่ตั้งไว้ของบัญชี และแสดงเฉพาะข้อมูลที่เพิ่งได้รับ หลังยืนยันตัวตนสำเร็จ ยังต้องอ่าน runtime_status แยกต่างหากก่อนถือว่าการเชื่อมต่อพร้อมใช้งาน
UnifyPort เป็นอินเทอร์เฟซที่ไม่เป็นทางการ คำสั่งยกเลิกนี้ไม่ใช่การออกจากระบบทุกเซสชันของแพลตฟอร์ม และไม่ได้ยกเลิกมาตรการรักษาความปลอดภัยของผู้ให้บริการ
คำถามที่พบบ่อย
ปิดหน้าต่าง QR เท่ากับยกเลิกหรือไม่?
ไม่ใช่ การปิดหน้าต่างเปลี่ยนเฉพาะ UI การยกเลิกฝั่งเซิร์ฟเวอร์ต้องใช้ API ที่รองรับ
QR หมดอายุแล้วควรยกเลิกอัตโนมัติหรือไม่?
ไม่ควร การหมดอายุเกี่ยวกับข้อมูลล็อกอินที่แสดงอยู่ ให้อ่านสถานะและใช้ขั้นตอนอัปเดตของผู้ให้บริการ เว้นแต่ผู้ใช้ต้องการเลิกจริง ๆ
หลัง timeout แสดงว่ายกเลิกสำเร็จได้หรือไม่?
ไม่ได้ ให้แสดงว่าผลยังไม่ยืนยันและตรวจสอบสถานะ อย่าเริ่มโฟลว์ใหม่ทันทีหรือส่งยกเลิกซ้ำต่อเนื่อง
การยกเลิกหยุดเก็บเงินหรือลบข้อความหรือไม่?
สัญญาการยกเลิกไม่ได้รับรองทั้งสองอย่าง แยกการเลิกใช้บัญชี การเรียกเก็บเงิน การล้างข้อความที่เก็บไว้ และการควบคุมยืนยันตัวตนออกจากกัน
ขั้นตอนถัดไปและแหล่งข้อมูล
ใช้เอกสาร Cancel authenticationประกอบการพัฒนา ทดสอบคำตอบ polling ที่มาช้า สองแท็บ การอนุมัติที่ชนกับการยกเลิก คำตอบสูญหาย และการเริ่มใหม่โดยตั้งใจ รายการนี้เป็นข้อเสนอการทดสอบ ไม่ใช่ผลที่ทดสอบแล้ว
ตรวจสอบแหล่งข้อมูลเมื่อ 2026-11-12:
เปลี่ยนการเชื่อมต่อข้อความให้เป็น pipeline ผลิตภัณฑ์ที่เสถียร
เริ่มจากการส่งผ่าน API เดียว แล้วส่งข้อความขาเข้าทั้งหมดกลับสู่ระบบธุรกิจของคุณด้วย event มาตรฐาน