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

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

คุณสามารถตรวจสอบสถานะของการส่งข้อมูลได้โดยใช้ endpoint ของ submission status API ซึ่งช่วยให้คุณติดตามได้ว่าการส่งข้อมูลของผู้ใช้ได้รับการยืนยันแล้ว ถูกยกเลิกแล้ว หรือยังอยู่ระหว่างดำเนินการ
สำหรับข้อมูลโดยละเอียดเกี่ยวกับข้อกำหนดการยืนยันตัวตนและสเปก 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):
export PAYLOAD='{
  "id": "seek-pass-test-a9a4839f-53d9-4064-8b0b-1348113a33f8",
  "document_type": "open_cert",
  "credential_type": "education",
  "data": {
    "credential": {
      "full_name": "John Smith",
      "education_provider": "University of Melbourne",
      "course_name": "Bachelor of Commerce",
      "conferral_year": "2024",
    },
    "document": "<OPEN_CERTS>"
  }
}'

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

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

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

คำขอ

สามารถดึงสถานะการส่งได้สูงสุด 30 สถานะ
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" },
      { "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e", "status": "incomplete", "finalized_at": null }
    ]
}
Chevronก่อนหน้า: เปลี่ยนเส้นทางผู้ใช้
ถัดไป: โฟลว์การผสานระบบChevron