นักพัฒนา

PUT/tcr/v2/brand/{brandId}/revet

ยืนยันแบรนด์สำหรับส่งข้อความอีกครั้ง

ส่งคำขอตรวจสอบตัวตนหนึ่งครั้งซึ่งคิดค่าธรรมเนียมแยกต่างหาก หลังจากแก้ไขโปรไฟล์ธุรกิจที่มีอยู่ แล้วติดตามผล

ในหน้านี้
  1. ตรวจสอบข้อมูลตัวตนของธุรกิจที่แก้ไขแล้วอีกครั้ง
  2. ตรวจทานแบรนด์ก่อนส่งคำขอ
  3. ยืนยันค่าธรรมเนียมที่คิดแยกต่างหาก
  4. ส่งคำขอตรวจสอบหนึ่งครั้งตามที่ตั้งใจไว้
  5. อ่านผลลัพธ์และติดตามสถานะ
  6. จัดการเมื่อผลลัพธ์ไม่แน่ชัด
  7. การใช้พอร์ทัลลูกค้า

ตรวจสอบข้อมูลตัวตนของธุรกิจที่แก้ไขแล้วอีกครั้ง

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

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

ตรวจทานแบรนด์ก่อนส่งคำขอ

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

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

ยืนยันค่าธรรมเนียมที่คิดแยกต่างหาก

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

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

ส่งคำขอตรวจสอบหนึ่งครั้งตามที่ตั้งใจไว้

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

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

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

อ่านผลลัพธ์และติดตามสถานะ

การตอบกลับสำหรับการยืนยันอีกครั้ง
การตอบกลับความหมายและสิ่งที่ต้องทำต่อ
200คำขอสำเร็จ ตรวจสอบแบรนด์ที่ส่งกลับมาและอ่านข้อมูลแบรนด์ปัจจุบันอีกครั้งเพื่อยืนยันสถานะตัวตน
202รับคำขอแล้ว และกำลังรอการตรวจสอบเพิ่มเติม เก็บรหัสแบรนด์ไว้และตรวจสอบสถานะปัจจุบันในภายหลัง โดยไม่ส่งคำขอตรวจสอบที่มีค่าธรรมเนียมอีกครั้ง
400ตรวจทานข้อผิดพลาดที่หน่วยงานทะเบียนส่งกลับมา การลงทะเบียนครั้งแรกอาจยังรอดำเนินการ โปรไฟล์อาจไม่มีการเปลี่ยนแปลง หรืออาจมีการใช้กฎตรวจสอบความถูกต้องอื่น
401 / 404ตรวจสอบข้อมูลรับรองและที่อยู่ IP ที่ได้รับอนุญาต หรือรหัสแบรนด์ที่เป็นของบัญชี
402 / 503ตรวจทานข้อผิดพลาดภายในระบบเกี่ยวกับการซื้อ/การเติมเงิน หรือการกำหนดราคา/บริการ อย่าถือว่าการตอบกลับ 503 ทุกครั้งพิสูจน์ว่าไม่มีการส่งคำขอไปยังระบบต้นทาง
429ปฏิบัติตาม Retry-After และคงรายละเอียดการตรวจสอบครั้งเดิมไว้

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

จัดการเมื่อผลลัพธ์ไม่แน่ชัด

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

การใช้พอร์ทัลลูกค้า

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

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