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

เอกสารรับรองสากล

Info
ข้อมูลรับรองทั่วไปรองรับเฉพาะใน API เวอร์ชัน 2 (/api/partner/v2/add/requests/universal_credential) คำขอต้องใช้ write.universal OAuth scope

คำอธิบายฟิลด์

คุณสามารถแนบเอกสารประกอบได้สูงสุดหนึ่งฉบับต่อ credential; ไฟล์แนบต้องเป็น pdf, png หรือ jpg ไม่ต้องใส่ assets หากไม่มีเอกสาร
ดู OpenAPI specification สำหรับสคีมาแบบเต็ม (รวมถึงฟิลด์ที่ไม่บังคับ)
{
  "credential_id": { "type": "string" }, // (Required) Unique identifier for this credential payload
  "fields": { // { "type": "object" }, (Required)
    "full_name": { "type": "string" }, // (Required)
    "credential_name": { "type": "string" }, // (Required)
    "credential_category": { "type": "string" }, // (Required) See supported credential categories below
    "issuer_name": { "type": "string" }, // (Required)
    "expiry_date": { "type": ["string", "null"], "format": "date" }, // (Optional) Date format: "YYYY-MM-DD"
    "credential_details": { // (Optional) { "type": ["object", "null"] }
      "scope_of_practice": { "type": ["string", "null"] },
      "speciality": { "type": ["array", "null"], "items": { "type": "string" } },
      "version": { "type": ["string", "null"] },
      "date_completed": { "type": ["string", "null"], "format": "date" },
      "country": { "type": ["string", "null"] },
      "state": { "type": ["string", "null"] },
      "province": { "type": ["string", "null"] },
      "city": { "type": ["string", "null"] },
      "region": { "type": ["string", "null"] },
      "place": { "type": ["string", "null"] }
    }
  },
  "assets": [ // (Optional) Omit when there is no supporting document; up to one asset
    {
      "asset_id": { "type": "string" }, // (Required when assets are present)
      "asset_type": { "type": "string" }, // (Required when assets are present) One of "pdf", "jpg", "png"
      "asset_data": { "type": ["string", "null"] } // URL or data URL for the document
    }
  ]
}

หมวดหมู่ credential ที่รองรับ

ใช้หนึ่งในค่าต่อไปนี้สำหรับ fields.credential_category SEEK Pass อาจเพิ่มหมวดหมู่ที่รองรับในอนาคต โปรดตรวจสอบคู่มือนี้หรือ OpenAPI specification เพื่อดูการอัปเดต
  • AVPRC Registration

ฟิลด์ที่จำเป็น

  • credential_id: ตัวระบุเฉพาะสำหรับ payload ของ credential นี้
  • fields.full_name: ชื่อเต็มของบุคคลตามที่ควรปรากฏบน credential
  • fields.credential_name: ชื่อเรื่องหรือชื่อของคุณวุฒิหรือ credential
  • fields.credential_category: หมวดหมู่ของ credential ต้องเป็นหนึ่งในหมวดหมู่ที่รองรับที่ระบุไว้ด้านบน
  • fields.issuer_name: องค์กรที่ออก credential

ตัวอย่าง payload

{
  "credential_id": "uc_ext_1",
  "fields": {
    "full_name": "John Doe",
    "credential_name": "Test Credential",
    "credential_category": "AVPRC Registration",
    "issuer_name": "Test Issuer",
    "expiry_date": "2026-08-31",
    "credential_details": {
      "scope_of_practice": "Registered Veterinary Nurse",
      "speciality": [
        "Speciality #1",
        "Speciality #2"
      ],
      "version": "V2025",
      "date_completed": "2018-08-31",
      "country": "Australia",
      "state": "Victoria",
      "city": "Melbourne"
    }
  },
  "assets": [
    {
      "asset_id": "asset_id_1",
      "asset_type": "pdf",
      "asset_data": "https://example.com/certificate.pdf"
    }
  ]
}