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

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

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

สถานะ

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

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

คำขอ

curl -L $SEEK_PASS_URL/api/partner/v2/add/requests/$CREDENTIAL_ID \
-H "Accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"
CREDENTIAL_ID คือค่าที่ส่งในฟิลด์ credential_id ในเนื้อหาคำขอของ เอนด์พอยต์ Partner Add (/api/partner/v2/add/requests/education.json):

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


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

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

คำขอ

สามารถดึงข้อมูลสถานะการส่งข้อมูลได้สูงสุด 30 รายการ หากไม่พบ ID ใดที่ส่งมา ระบบจะไม่ส่งคืนสถานะข้อผิดพลาด แต่จะไม่มีข้อมูลสำหรับ ID นั้นในข้อมูลการตอบกลับ
curl -G -L $SEEK_PASS_URL/api/partner/v2/add/requests \
-H "Accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data-urlencode "credential_id[]=f25c6425-eed4-4853-95bc-fb19aacd4e1e" \
--data-urlencode "credential_id[]=b10a30c1-1109-417a-83d3-9d06185ddd0e"

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


200 OKตัวอย่างการตอบกลับ:
{
  "credentials": [
    {
      "credential_id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e",
      "status": "verified",
      "finalized_at": "2026-01-01T12:00:00Z",
      "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
    },
    {
      "credential_id": "b10a30c1-1109-417a-83d3-9d06185ddd0e",
      "status": "incomplete",
      "finalized_at": null,
      "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
    }
  ]
}