ใช้แบรนด์สำหรับรับส่งข้อความที่บัญชีนั้นเป็นเจ้าของ
ใช้บัญชี API ที่เปิดใช้งานแล้วผ่าน HTTPS จากที่อยู่ IP ต้นทางที่ได้รับอนุญาต รองรับการยืนยันตัวตนแบบ Basic และ Bearer รหัสแบรนด์ต้องเป็นของบัญชีนั้น เก็บโทเคนของผู้ให้บริการ ข้อมูลระบุตัวตนของแบรนด์ และรายงานที่ได้รับกลับมาไว้เป็นความลับ
สั่งซื้อการตรวจสอบภายนอกครั้งใหม่
ใช้ POST เมื่อต้องการให้ผู้ให้บริการตรวจสอบดำเนินการตรวจสอบแบรนด์นี้ใหม่ หากมีผลลัพธ์จากผู้ให้บริการอยู่แล้ว ให้ใช้ การนำเข้าผลลัพธ์ แทน การดำเนินการนี้แยกจาก การยืนยันตัวตนของแบรนด์ซ้ำ.
อ่านข้อมูลปัจจุบันของแบรนด์และยืนยันข้อมูลระบุตัวตนก่อน เลือกผู้ให้บริการและประเภทการตรวจสอบที่รองรับจาก รายการข้อมูลอ้างอิงปัจจุบัน และตรวจสอบข้อกำหนดของผู้ให้บริการรายนั้น ผู้ให้บริการแต่ละรายอาจไม่ได้รองรับทุกประเภท รายละเอียดเพิ่มเติมสำหรับการตรวจสอบทางการเมืองต้องอธิบายองค์กรหรือแคมเปญจริง ไม่ใช่ข้อมูลตัวอย่าง
เตรียมคำขอสำหรับผู้ให้บริการ
| ฟิลด์ | ค่า |
|---|---|
| evpId | รหัสผู้ให้บริการที่จำเป็นต้องระบุ โดยเลือกจากรายการผู้ให้บริการตรวจสอบภายนอกปัจจุบัน มีความยาว 1–10 อักขระ |
| vettingClass | ประเภทการตรวจสอบที่รองรับซึ่งคุณตั้งใจจะซื้อ เลือกให้ชัดเจนและยืนยันราคา |
| additionalRequestPayload | สตริงที่เข้ารหัสในรูปแบบ JSON ซึ่งมีรายละเอียดเฉพาะของผู้ให้บริการ จำเป็นสำหรับการตรวจสอบทางการเมือง ค่านี้เป็นสตริงภายในออบเจ็กต์ JSON ชั้นนอก ไม่ใช่ออบเจ็กต์ซ้อน ยืนยันรายละเอียดที่จำเป็นทั้งหมดกับผู้ให้บริการที่เลือก |
ยืนยันค่าธรรมเนียมกรณีสำเร็จและล้มเหลว
ค่าธรรมเนียมขายปลีกปัจจุบันเป็นดอลลาร์สหรัฐ อ้างอิงข้อมูลที่อ่านเมื่อวันที่ 24 ตุลาคม 2026 ยืนยันยอดปัจจุบันก่อนสั่งซื้อจริง ระบบจะตรวจสอบยอดเงินที่ชำระล่วงหน้าเทียบกับราคากรณีสำเร็จ และต้องเปิดใช้งานการซื้อไว้
| ประเภทการตรวจสอบ | ผลลัพธ์ที่มีผลใช้งาน | ผลลัพธ์ที่ล้มเหลว |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL พร้อมคำขอ Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
คำสั่งซื้อที่รอดำเนินการจะคงยอดเงินกรณีสำเร็จ/ล้มเหลวไว้ และจะชำระบัญชีเมื่อซิงโครไนซ์ผลลัพธ์ ACTIVE หรือ FAILED แล้ว สองประเภทสุดท้ายในตารางใช้ค่าธรรมเนียมที่กำหนดไว้เท่ากันสำหรับผลลัพธ์สุดท้ายทั้งสองแบบ หากได้ผลลัพธ์สุดท้ายทันที อาจมีการเรียกเก็บเงินระหว่างการตอบกลับคำสั่งซื้อ การซิงโครไนซ์สถานะในภายหลังสามารถชำระบัญชีค่าธรรมเนียมที่ค้างอยู่ได้
อย่าถือว่า mock:true เป็นการรับประกันว่าการตรวจสอบภายนอกจะไม่มีค่าใช้จ่าย กระบวนการชำระบัญชีสำหรับการตรวจสอบภายนอกในปัจจุบันยังคงสามารถบันทึกและเรียกเก็บเงินสำหรับคำสั่งซื้อนั้นได้ คำแนะนำนี้ไม่ได้กำหนดให้ซื้อจริงเพื่อทดสอบ ให้ใช้ชุดข้อมูลทดสอบแบบออฟไลน์จนกว่าคุณจะตั้งใจอนุมัติการตรวจสอบที่มีค่าใช้จ่าย
ส่งคำสั่งซื้อที่ทบทวนแล้วหนึ่งรายการ
เตรียม vetting-order.json โดยระบุรหัสผู้ให้บริการ ประเภทการตรวจสอบ และข้อมูลเพิ่มเติมที่จำเป็นทั้งหมด ไฟล์นี้มีคำขอจริงที่คุณตั้งใจจะส่ง เก็บไฟล์ไว้เป็นความลับ
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"ติดตามผลลัพธ์จริง
การตอบกลับ HTTP ที่สำเร็จอาจมีระเบียนการตรวจสอบที่ยังรอดำเนินการ เก็บ vettingId ของระเบียนนั้นไว้ และตรวจสอบ vettingStatus เหตุผล คะแนน และวันที่มีผล/วันหมดอายุเท่าที่มีให้ สถานะ PENDING และ UNSCORE ต้องติดตามต่อ ส่วน ACTIVE, FAILED และ EXPIRED อธิบายผลลัพธ์ที่แตกต่างกัน การยอมรับในระดับ HTTP เพียงอย่างเดียวไม่ได้พิสูจน์ว่าได้คะแนนที่ดีหรือแคมเปญมีคุณสมบัติตามเกณฑ์
ใช้ สถานะการตรวจสอบภายนอก เพื่อติดตามระเบียน การอ่านหรือนำเข้าผลลัพธ์สุดท้ายสามารถชำระบัญชีคำสั่งซื้อที่มีค่าใช้จ่ายก่อนหน้านี้ได้ การดำเนินการดังกล่าวจึงไม่ได้หมายความว่าจะไม่มีการเรียกเก็บค่าธรรมเนียมที่ค้างอยู่เดิมเสมอไป
ลองส่งคำขอเดิมที่ตั้งใจไว้อีกครั้ง
ใช้ Idempotency-Key หนึ่งค่าต่อการดำเนินการที่ตั้งใจไว้แต่ละครั้ง และเก็บเมธอด เส้นทาง สตริงคิวรี และไบต์ของเนื้อหาคำขอให้ตรงตามเดิมทุกประการ คีย์รองรับอักขระ ASCII ที่พิมพ์ได้ 1–128 ตัวโดยไม่มีช่องว่าง คำขอซ้ำที่ส่งขณะคำขอเดิมกำลังดำเนินการอาจได้รับ 409 พร้อม Retry-After คำขอที่เสร็จสิ้นแล้วจะส่งการตอบกลับที่บันทึกไว้ซ้ำ รวมถึงข้อผิดพลาดด้วย ปฏิบัติตามขีดจำกัดอัตราการส่งคำขอ
ข้อผิดพลาด 502 ที่แคชไว้อาจเกิดตามหลังความล้มเหลวในการรับส่งข้อมูล ข้อผิดพลาด 500 ที่แคชไว้พร้อม requestId อาจหมายความว่าระบบทะเบียนยอมรับการดำเนินการแล้ว แต่การบันทึกข้อมูลถาวรภายในระบบหรือการเรียกเก็บเงินล้มเหลว เก็บรหัสคำขอไว้ ตรวจสอบระเบียนปัจจุบัน และตรวจสอบกระทบยอดกับฝ่ายสนับสนุนก่อนใช้คีย์ใหม่ อย่าสันนิษฐานว่าข้อผิดพลาดหมายความว่าไม่มีคำสั่งซื้ออยู่