เพิกถอนคำขอ

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

สำหรับข้อมูลโดยละเอียดเกี่ยวกับข้อกำหนดการตรวจสอบสิทธิ์และข้อกำหนด API โปรดดู OpenAPI specification V2

คำขอ

การยืนยันตัวตนต้องใช้โทเค็น JWT ที่มี revoke.credential ขอบเขต OAuth

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.

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

คำขอแต่ละรายการต้องมีเหตุผลเป็นหนึ่งในค่าต่อไปนี้:

information_discrepancy — ข้อมูลการรับรองไม่ถูกต้อง ผู้สมัครอาจได้รับการแจ้งเตือนทางอีเมล
user_initiated — ผู้สมัครได้ขอการลบ ผู้สมัครอาจได้รับการแจ้งเตือนทางอีเมล
suspicious_activity — กำลังเพิกถอนการรับรองเนื่องจากกิจกรรมที่น่าสงสัย ไม่มีการส่งการแจ้งเตือนทางอีเมล

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

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

ก่อนหน้า: ตรวจสอบสถานะการส่งข้อมูล

ถัดไป: โฟลว์การผสานระบบ