ยุติการใช้งานแบรนด์สำหรับการส่งข้อความ

เลือกขั้นตอนการยุติการใช้งาน

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

การเรียก DELETE แบรนด์ผ่านช่องทางสาธารณะกับการดำเนินการ ลบแบรนด์ ในพอร์ทัลมีขอบเขตต่างกัน การเรียกผ่านช่องทางสาธารณะจะลบแบรนด์หนึ่งรายการในระบบทะเบียน ส่วนพอร์ทัลจะประสานงานการยกเลิกการกำหนดหมายเลขและการปิดใช้งานแคมเปญก่อนพยายามลบแบรนด์

ตรวจสอบผลกระทบในพอร์ทัล

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

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

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

เตรียมการลบโดยตรงผ่าน API

ใช้บัญชี API ที่เปิดใช้งานแล้วผ่าน HTTPS จากที่อยู่ IP ต้นทางที่ได้รับอนุญาต แบรนด์ต้องเป็นของบัญชีนั้น อ่านและเก็บรหัสกับสถานะปัจจุบันของแบรนด์ไว้ จากนั้นตรวจสอบแคมเปญและการกำหนดหมายเลข ยกเลิกการกำหนดหมายเลขที่ได้รับผลกระทบและ ปิดใช้งานแคมเปญ ก่อนลบแบรนด์ อย่าถือว่าการเรียก DELETE นี้เป็นการลบแบบต่อเนื่องที่ลบรายการที่เกี่ยวข้องไปด้วย

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

ลบแบรนด์ที่ตรวจสอบแล้ว

เรียกใช้คำสั่งต่อไปนี้เฉพาะสำหรับการยุติการใช้งานที่ตั้งใจไว้ หลังจากตรวจสอบรหัสแบรนด์และล้างข้อมูลตามขั้นตอนก่อนหน้าครบแล้ว คำขอนี้ไม่มีเนื้อหาแบบ JSON

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

ผลสำเร็จตามที่ระบุในเอกสารคือ HTTP 204 โดยไม่มีเนื้อหาการตอบกลับ อย่ากำหนดว่าต้องมีออบเจ็กต์แสดงความสำเร็จแบบ JSON หรือโครงสร้างครอบ status/response แบบเดิมของ v3 ผลที่ถูกปฏิเสธซึ่งมีรหัสนอกกลุ่ม 2xx จะไม่ทำเครื่องหมายว่าแบรนด์ถูกลบผ่านกระบวนการซิงโครไนซ์ API ปัจจุบัน

ใช้คีย์ป้องกันการดำเนินการซ้ำหนึ่งคีย์สำหรับคำขอที่ตั้งใจไว้ เมื่อส่งซ้ำ ให้คงเมธอด เส้นทาง ข้อความค้นหา และไบต์ของเนื้อหาคำขอไว้เหมือนเดิมทุกประการ คีย์นี้ไม่ได้ทำให้กระบวนการล้างข้อมูลทั้งหมดของพอร์ทัลเป็นธุรกรรมแบบอะตอมมิก และไม่ได้พิสูจน์ว่าหมายเลขถูกยกเลิกการกำหนดที่ผู้ให้บริการเครือข่ายแล้ว คำขอซ้ำที่คำขอเดิมยังอยู่ระหว่างดำเนินการอาจได้รับ 409 พร้อม Retry-After ส่วนคำขอที่เสร็จแล้วอาจส่งการตอบกลับที่บันทึกไว้กลับมาอีกครั้ง รวมถึงการตอบกลับที่เป็นข้อผิดพลาดด้วย

ตรวจสอบการยุติการใช้งานและปรับผลลัพธ์ที่สำเร็จบางส่วนให้สอดคล้องกัน

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

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

สำหรับ HTTP 400 ให้อ่านรายละเอียดข้อผิดพลาดจากระบบทะเบียน โดยเฉพาะข้อจำกัดจากแคมเปญที่ยังใช้งานอยู่ สำหรับ 401, 403 หรือ 404 ให้ตรวจสอบข้อมูลรับรอง IP ต้นทางที่ได้รับอนุญาต และความเป็นเจ้าของของบัญชี สำหรับ 429 ให้ปฏิบัติตาม Retry-After การหมดเวลารอ รหัส 500 หรือ 502 อาจเกิดขึ้นหลังจากการเปลี่ยนแปลงในระบบภายนอกเสร็จสิ้นแล้ว ให้ตรวจสอบการลงทะเบียนที่มีอยู่ก่อนส่งคำขอซ้ำ

ตรวจสอบค่าใช้จ่ายที่ยังเหลือของบัญชี

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