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

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

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

การส่งข้อมูลครั้งเดียว

คำขอ

curl -L $SEEK_PASS_URL/api/partner/v1/submissions/$ID/status.json \
-H "Authorization: Bearer $ACCESS_TOKEN"
ID คือค่าที่ใส่ในฟิลด์ id ใน request body ของ Partner Add endpoint (/api/partner/v1/add/$CREDENTIAL_TYPE.json):

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

200 OK: พบสถานะการส่งข้อมูลตัวอย่างการตอบกลับเมื่อข้อมูลได้รับการยืนยันแล้ว:
{
    "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e",
    "status": "verified",
    "finalized_at": "2026-01-01T12:00:00Z",
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}
ตัวอย่างการตอบกลับเมื่อยกเลิกการส่งข้อมูล (ผู้ใช้ยกเลิกข้อมูลรับรอง):
{
    "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e",
    "status": "canceled",
    "finalized_at": "2026-01-01T12:00:00Z",
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}
ตัวอย่างการตอบกลับเมื่อการส่งข้อมูลกำลังดำเนินการอยู่ (ผู้ใช้ยังทำขั้นตอนไม่เสร็จ):
{
    "id": "3e8f0108-6b86-4c96-b197-aeec85aff942",
    "status": "incomplete",
    "finalized_at": null,
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}

การส่งข้อมูลหลายรายการ

คำขอ

สามารถดึงข้อมูลสถานะการส่งข้อมูลได้สูงสุด 30 รายการ หากไม่พบ ID ใดที่ส่งมา ระบบจะไม่ส่งคืนสถานะข้อผิดพลาด แต่จะไม่มีข้อมูลสำหรับ ID นั้นในข้อมูลการตอบกลับ
curl -X POST -L $SEEK_PASS_URL/api/partner/v1/submissions/status.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-d '{"ids":["f25c6425-eed4-4853-95bc-fb19aacd4e1e","b10a30c1-1109-417a-83d3-9d06185ddd0e"]}'

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

200 OKตัวอย่างการตอบกลับ:
{
    "credentials": [
      { "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e", "status": "verified", "finalized_at": "2026-01-01T12:00:00Z", "redirect_uri": "https://app.seekpass-staging.com/partner/add/..." },
      { "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e", "status": "incomplete", "finalized_at": null, "redirect_uri": "https://app.seekpass-staging.com/partner/add/..." }
    ]
}
Chevronก่อนหน้า: เปลี่ยนเส้นทางผู้ใช้
ถัดไป: โฟลว์การผสานระบบChevron