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