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

การเรียนรู้และพัฒนาตนเอง (Microcredential)

คำขอ การเรียนรู้และพัฒนาตนเอง (Microcredential) ควรใช้ API เวอร์ชัน 2 API เวอร์ชัน 1 ถูกเลิกใช้แล้ว และพาร์ทเนอร์ต้องย้ายการเชื่อมต่อที่มีอยู่ การเชื่อมต่อใหม่ต้องใช้ API เวอร์ชัน 2 กำหนดเวลาการย้ายคือ TBA ดูคู่มือการย้ายและใช้ API เวอร์ชัน 2.
คำขอ API ต้องใช้ OAuth scope write.microcredential ดูที่ OAuth authentication

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

ดู OpenAPI Specification V2 สำหรับสคีมาแบบเต็ม (รวมถึงฟิลด์ที่ไม่บังคับ)
สำคัญ: กรุณาตรวจสอบให้แน่ใจว่าไฟล์เอกสารที่แนบมา (ถ้ามี) อยู่ในรูปแบบ PDF, PNG, JPG หรือ OpenCert
{
  "credential_id": { "type": "string" }, // (Required) Unique identifier for the credential
  "fields": { // { "type": "object" }, (Required)
    "full_name": { "type": "string" }, // (Required)
    "issuer_name": { "type": "string" }, // (Required)
    "microcredential_name": { "type": "string" }, // (Required)
    "issue_date": { "type": "string" }, // (Required) Date format: "YYYY-MM-DD"
    "expiry_date": { "type": ["string", "null"] }, // (Optional) Date format: "YYYY-MM-DD"
    "assessment_result": { "type": ["string", "null"] }, // (Optional) Text description
    "partner_chain": { "type": ["array", "null"] } // (Optional) e.g. [{ "name": "Partner Organization" }]
  },
  "assets": [ // { "type": ["array", "null"] }, (Optional) Omit when there is no document
    {
      "asset_id": { "type": "string" }, // (Required) Unique identifier for the asset
      "asset_type": { "type": "string" }, // (Required) "pdf", "png", "jpg", or "open_cert"
      "asset_data": { "type": ["string", "null"] } // URL pointing to a PDF/JPG/PNG document, or OpenCert content
    }
  ]
}

การใช้ประโยชน์จากฟิลด์ Learning and Development

ชื่อ Microcredential

ระบุชื่อ microcredential ที่อธิบายชื่อคุณวุฒิได้อย่างชัดเจน ซึ่งจะช่วยให้ผู้ประกอบการเข้าใจความสำเร็จเมื่อแสดงบนโปรไฟล์ของผู้ใช้
อย่าใช้ประเภทใบรับรองทั่วไปเป็นชื่อ microcredential (เช่น *Certificate of Participation* หรือ *Certificate of Completion*) เพราะไม่เหมาะสำหรับการยืนยัน

ชื่อผู้ออกเอกสาร

ฟิลด์ issuing party ต้องแสดงแหล่งที่มาของคุณวุฒิอย่างชัดเจน และควรอธิบายได้เพียงพอเพื่อให้เป็นประโยชน์ต่อผู้ประกอบการเมื่อแสดงบนโปรไฟล์ของผู้ใช้

ตัวอย่าง

ไม่เหมาะสมClear
เหมาะสมTick
{ `issuer_name`: "LearningProvider" `microcredential_name`: "*Certificate of Completion*" }
{ `issuer_name`: "LearningProvider" `microcredential_name`: "Microsoft Excel Skills" }
{ `issuer_name`: "Management" `microcredential_name`: "Management skills" }
{ `issuer_name`: "ABC Management Academy" `microcredential_name`: "Management skills" }

ห่วงโซ่พาร์ทเนอร์

ฟิลด์ partner_chain ใช้เก็บความสัมพันธ์ระดับกลางในลำดับชั้นพาร์ทเนอร์แบบหลายชั้นที่ไม่ได้แสดงไว้ในส่วนอื่นของการผสานรวม ซึ่งช่วยเพิ่มความละเอียดของการวิเคราะห์ที่ SEEK Pass สามารถมอบให้คุณได้คลิกที่นี่เพื่อดูรายละเอียดเพิ่มเติม

ตัวอย่าง payload

พร้อมเอกสาร PDF

{
  "credential_id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "fields": {
    "full_name": "John Doe",
    "issuer_name": "ExampleProvider",
    "microcredential_name": "Skill Test #1",
    "issue_date": "2024-08-31",
    "expiry_date": "2026-08-31",
    "assessment_result": "85%"
  },
  "assets": [
    {
      "asset_id": "certificate-pdf-1",
      "asset_type": "pdf",
      "asset_data": "https://example.com/certificate.pdf"
    }
  ]
}

พร้อมเอกสาร OpenCert

{
  "credential_id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "fields": {
    "full_name": "John Doe",
    "issuer_name": "ExampleProvider",
    "microcredential_name": "Skill Test #2",
    "issue_date": "2024-08-31",
    "expiry_date": "2026-08-31",
    "assessment_result": "Pass"
  },
  "assets": [
    {
      "asset_id": "open-cert-1",
      "asset_type": "open_cert",
      "asset_data": "{\"version\":\"https://schema.openattestation.com/2.0/schema.json\",\"schema\":\"https://raw.githubusercontent.com/OpenCerts/open-certificate/master/schema/transcripts/2.0/schema.json\"}"
    }
  ]
}

ไม่มีเอกสาร

{
  "credential_id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "fields": {
    "full_name": "John Doe",
    "issuer_name": "ExampleProvider",
    "microcredential_name": "Skill Test #3",
    "issue_date": "2024-08-31",
    "expiry_date": "2026-08-31"
  }
}

กับ partner_chain

{
  "credential_id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "fields": {
    "full_name": "John Doe",
    "issuer_name": "ExampleProvider",
    "microcredential_name": "Skill Test #1",
    "issue_date": "2024-08-31",
    "expiry_date": "2026-08-31",
    "assessment_result": "85%",
    "partner_chain": [{ "name": "Partner Organization" }]
  },
  "assets": [
    {
      "asset_id": "certificate-pdf-1",
      "asset_type": "pdf",
      "asset_data": "https://example.com/certificate.pdf"
    }
  ]
}