Pembelajaran dan Pengembangan (Mikrokredensial)

Pembelajaran dan Pengembangan tersedia di API versi 1 dan 2. Namun, API versi 1 akan dihentikan pada masa mendatang, sehingga integrasi baru sebaiknya menggunakan API versi 2. Permintaan memerlukan cakupan OAuth write.microcredential.

Deskripsi kolom

Penting: Pastikan file dokumen terlampir (jika ada) berformat PDF, PNG, JPG, atau OpenCert.

Lihat spesifikasi OpenAPI untuk skema lengkap (termasuk bidang opsional).

{
  "id": { "type": "string" }, // (Required) Unique identifier for the data
  "credential_type": { "type": "string" }, // (Required) Must be "microcredential"
  "document_type": { "type": "string" }, // (Required) Must be one of "pdf", "png", "jpg", "open_cert", or "none"
  "data": { // { "type": "object" }, (Required)
    "credential": { // { "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" }, // (Optional) Date format: "YYYY-MM-DD"
      "assessment_result": { "type": ["string", null] }, // (Optional) Text description
      "partner_chain": { "type": ["array", "null"] } // (Optional unless otherwise specified) Array of objects to specifiy partner institutions, e.g. [{ "name": "Partner Organization" }]
    },
    "document": { "type": "string" }, // (Optional) Depending on the supplied document_type, either a URL pointing to a PDF/JPG/PNG document, the content of an OpenCert document, or null if not applicable.
  }
}

Memanfaatkan kolom Pembelajaran dan Pengembangan

Nama mikrokredensial

Berikan nama microcredential yang jelas menggambarkan judul kualifikasi. Ini membantu perekrut memahami pencapaian saat ditampilkan di profil pengguna.

Jangan gunakan jenis sertifikat umum sebagai nama mikrokredensial (misalnya *Certificate of Participation* atau *Certificate of Completion*). Ini tidak cocok untuk verifikasi.

Nama penerbit

Bidang pihak penerbit harus jelas merepresentasikan sumber kualifikasi. Pastikan deskripsinya cukup jelas agar berguna bagi perekrut saat muncul di profil pengguna.

Contoh

Tidak cocok	Sesuai
{ `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" }

Rantai mitra

Kolom partner_chain mencatat hubungan perantara dalam hierarki mitra berlapis yang tidak direpresentasikan di bagian lain dalam integrasi. Ini meningkatkan granularitas analitik yang dapat diberikan SEEK Pass kepada Anda.Klik di sini untuk detail lebih lanjut.

Contoh payload

Dengan dokumen PDF

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "credential_type": "microcredential",
  "document_type": "pdf",
  "data": {
    "document": "https://example.com/certificate.pdf",
    "credential": {
      "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%"
    }
  }
}

Dengan dokumen OpenCert

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "credential_type": "microcredential",
  "document_type": "open_cert",
  "data": {
    "document": "{\"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": {
      "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"
    }
  }
}

Tanpa dokumen

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "credential_type": "microcredential",
  "document_type": "none",
  "data": {
    "document": null,
    "credential": {
      "full_name": "John Doe",
      "issuer_name": "ExampleProvider",
      "microcredential_name": "Skill Test #3",
      "issue_date": "2024-08-31",
      "expiry_date": "2026-08-31"
    }
  }
}

Dengan `partner_chain`

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "credential_type": "microcredential",
  "document_type": "pdf",
  "data": {
    "document": "https://example.com/certificate.pdf",
    "credential": {
      "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" }]
    }
  }
}

Sebelumnya: Kemampuan Bahasa Inggris

Berikutnya: Izin untuk Bekerja