นำเข้าผลการตรวจสอบที่มีอยู่แล้ว

ใช้แบรนด์สำหรับการส่งข้อความที่บัญชีเป็นเจ้าของ

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

ใช้ผลที่มีอยู่แล้วจากผู้ให้บริการ

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

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

เตรียมการนำเข้า

สร้าง vetting-import.json โดยใช้ค่าจริงจากผู้ให้บริการ อย่าส่งฟิลด์คะแนน สถานะ หรือเวลาประทับที่มีไว้สำหรับการตอบกลับเท่านั้น โดยคิดว่าฟิลด์เหล่านี้จะเปลี่ยนผลลัพธ์ได้

นำเข้าผลเพียงครั้งเดียว

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @vetting-import.json \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"

ทำความเข้าใจค่าบริการที่มีอยู่แล้ว

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

ติดตามผลลัพธ์จริง

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

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

ลองส่งคำขอเดิมที่ตั้งใจไว้อีกครั้ง

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

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