ตรวจสอบผลการตรวจประเมินแบรนด์

เลือกแบรนด์ที่คุณกำลังตรวจสอบ

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

ติดตามการตรวจประเมินที่มีอยู่

เก็บค่า vettingId, evpId, vettingClass และ vettingStatus ไว้เมื่อมีข้อมูล การซิงโครไนซ์ในปัจจุบันถือว่า PENDING และ UNSCORE เป็นผลที่ยังรอการตรวจสอบเพิ่มเติม และถือว่า ACTIVE และ FAILED เป็นผลสิ้นสุดสำหรับการสรุปเรียกเก็บค่าบริการ อ่านรายละเอียดที่ส่งกลับมาก่อนตัดสินใจว่าต้องดำเนินการต่อหรือไม่ รายการว่างเพียงอย่างเดียวไม่ได้พิสูจน์ว่าคำขอที่ส่งก่อนหน้านี้ไปไม่ถึงระบบทะเบียน

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

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

ลองอ่านอีกครั้งโดยไม่ส่งคำสั่งใหม่

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

แยกขั้นตอนการลงทะเบียนออกจากกัน

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

คำขอ

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

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

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

ผลตอบกลับ

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

โครงสร้างผลตอบกลับเพื่อประกอบความเข้าใจ ไม่ใช่ข้อมูลบัญชีจริงหรือใบเสนอราคาปัจจุบัน

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

ข้อผิดพลาด

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

ความพร้อมใช้งานและผลที่เกิดขึ้นร่วมด้วย

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