เริ่มต้นใช้งาน
ข้อมูลหลัก
อื่นๆ

เพิกถอนคำขอ

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

คำขอ

การตรวจสอบสิทธิ์ต้องใช้โทเค็น JWT ที่มีขอบเขต OAuth revoke.credential
curl -X POST -L $SEEK_PASS_URL/api/partner/v2/add/requests/revoke.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "requests": [
        {
            "request_id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e",
            "reason": "information_discrepancy"
        }
    ]
}'
request_id เป็นค่าเดียวกับที่ระบุเป็น credential_id เมื่อมีการสร้างคำขอผ่าน Partner Add endpoint

เหตุผลในการเพิกถอน

คำขอแต่ละรายการต้องมีเหตุผลเป็นหนึ่งในค่าต่อไปนี้:
  • information_discrepancy — ข้อมูลรับรองไม่ถูกต้อง ผู้สมัครอาจได้รับการแจ้งเตือนทางอีเมล
  • user_initiated — ผู้สมัครขอลบข้อมูล ผู้สมัครอาจได้รับการแจ้งเตือนทางอีเมล
  • suspicious_activity — ข้อมูลรับรองกำลังถูกยกเลิกเนื่องจากมีกิจกรรมที่น่าสงสัย จะไม่มีการส่งการแจ้งเตือนทางอีเมล

รหัสการตอบกลับ


204 No Content: ยกเลิกคำขอเรียบร้อยแล้วยอมรับการยกเลิกแล้ว จะไม่มีการส่งคืนเนื้อหาการตอบกลับ หากคำขอถูกยกเลิกไปแล้ว endpoint จะยังคงส่งคืน 204