Kualifikasi Pendidikan

Kualifikasi Pendidikan 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.education.

Deskripsi kolom

Penting: Pastikan file berformat PDF atau OpenCert.

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

{
  "id": { "type": "string" }, // (Required) Unique identifier for the data
  "document_type": { "type": "string" }, // (Required) Must be one of "pdf", "open_cert", or "none"
  "credential_type": { "type": "string" }, // (Required) Must be "education"
  "data": { // { "type": "object" }, (Required)
    "credential": { // { "type": "object" }, (Required)
      "full_name": { "type": "string" }, // (Required)
      "education_provider": { "type": "string" }, // (Required)
      "course_name": { "type": "string" }, // (Required)
      "conferral_year": { "type": ["string", "null"] }, // (Required unless awaiting_graduation) Year: YYYY or null if awaiting graduation
      "awaiting_graduation": { "type": "boolean" }, // (Optional)
      "has_majors": { "type": "boolean" }, // (Optional)
      "majors": { "type": "array", "items": { "type": "string" } }, // (Optional)
      "with_honours": { "type": "boolean" }, // (Optional)
      "transcript": { // { "type": "object" }, // (Optional)
        "overall": { // { "type": "object" }, (Required)
          "issuance_date": { "type": "string" }, // (Required) Date format: "YYYY-MM-DD"
          "score": { "type": "string" }, // (Optional)
        },
        "subjects": [ // { "type": "array" }, (Required)
          {
            "name": { "type": "string" }, // (Required)
            "code": { "type": "string" }, // (Required)
            "credit": { "type": "string" }, // (Optional)
            "score": { "type": "string" }, // (Optional)
            "grade": { "type": "string" }, // (Required), e.g. "A+ or High Distinction or Pass"
            "completion_date": { "type": "string" }, // (Required) Year or ISO date
          }
        ]
      },
      "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 document, the content of an OpenCert document, or null if not applicable.
  }
}

Memanfaatkan kolom Pendidikan

Menyusun kualifikasi yang benar

Ada sejumlah pasangan nilai kunci yang digabungkan untuk membentuk kolom Kualifikasi. Kolom ini ditampilkan sebagai judul kredensial di SEEK Pass dan SEEK (mis. di Profil SEEK). Ini adalah kolom yang paling menonjol yang dilihat kandidat dan perekrut saat menggunakan produk kami, jadi kolom yang jelas dan representatif akan sangat berdampak. Kolom ini juga digunakan oleh tim internal SEEK untuk memetakan struktur dalam sistem kami.

Bidang berikut wajib diisi untuk menyusun bidang Kualifikasi yang benar:

course_name
majors
with_honours

Dengan demikian, ada cara-cara yang disarankan untuk memanfaatkan kolom-kolom ini:

1.
Tulis lengkap course_name (misalnya "Bachelor of Commerce" atau "Bachelor of Science" lebih disarankan, hindari "BCom" atau "BSc").
2.
Gunakan ejaan yang benar di course_name (mis. "Master of..." dan bukan "Masters of...").
3.
Gunakan kata penghubung standar di course_name (mis. "Master of..." alih-alih "Master in").
4.
Manfaatkan kolom majors jika relevan. Jangan juga mencantumkan jurusan dalam course name.
5.
Manfaatkan kolom with_honours jika relevan. Jangan juga mencantumkan honours dalam course_name.

Contoh 1

course_name: "Bachelor of Commerce"
majors: ["Economics", "Finance"]
with_honours: true
Kualifikasi: _Bachelor of Commerce (Economics and Finance) (Honours)_

Contoh 2

course_name: "Bachelor of Commerce"
majors: ["Finance"]
with_honours: false
Kualifikasi: _Bachelor of Commerce (Finance)_

Kualifikasi menunggu kelulusan

Kualifikasi Pendidikan yang sudah diselesaikan tetapi belum dianugerahkan karena upacara wisuda yang masih menunggu tetap dapat dikirim melalui Tambahkan ke SEEK Pass.

Persyaratan bidangnya adalah sebagai berikut:

conferral_year disetel ke null
awaiting_graduation disetel ke true

Bidang document_type juga dapat diatur menjadi none jika tidak ada dokumentasi pendukung yang relevan untuk menunjukkan bahwa Kualifikasi Pendidikan telah diselesaikan tetapi belum dianugerahkan.

Contoh

course_name: "Bachelor of Commerce"
majors: ["Finance"]
conferral_year: null
awaiting_graduation: true
Kualifikasi: _Bachelor of Commerce (Finance) (Menunggu kelulusan)_

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

Contoh OpenCerts: Bachelor of Commerce (Economics and Finance) (Honours)

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "document_type": "open_cert",
  "credential_type": "education",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "education_provider": "National University of Singapore",
      "course_name": "Bachelor of Commerce",
      "conferral_year": "2024",
      "has_majors": true,
      "majors": ["Economics", "Finance"],
      "with_honours": true,
      "transcript": {
        "overall": {
          "issuance_date": "2022",
          "score": "4.5"
        },
        "subjects": [
          {
            "name": "Introductory Microeconomics",
            "code": "ECON10001",
            "credit": "4",
            "score": "4.5",
            "grade": "A+",
            "completion_date": "2020"
          },
          {
            "name": "Introductory Macroeconomics",
            "code": "ECON10002",
            "credit": "4",
            "score": "3.5",
            "grade": "A",
            "completion_date": "2021"
          }
        ]
      }
    },
    "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\"}"
  }
}

Contoh sertifikat PDF

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "document_type": "pdf",
  "credential_type": "education",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "education_provider": "National University of Singapore",
      "course_name": "Bachelor of Commerce",
      "conferral_year": null,
      "awaiting_graduation": true,
      "has_majors": true,
      "majors": ["Economics", "Finance"]
    },
    "document": "https://example.com/certificate.pdf"
  }
}

Contoh menunggu kelulusan

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "document_type": "none",
  "credential_type": "education",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "education_provider": "National University of Singapore",
      "course_name": "Bachelor of Commerce",
      "conferral_year": null,
      "awaiting_graduation": true,
      "has_majors": true,
      "majors": ["Economics", "Finance"]
    },
    "document": null
  }
}

Contoh dengan partner_chain

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "document_type": "open_cert",
  "credential_type": "education",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "education_provider": "National University of Singapore",
      "course_name": "Bachelor of Commerce",
      "conferral_year": "2024",
      "has_majors": true,
      "majors": ["Economics", "Finance"],
      "with_honours": true,
      "partner_chain": [
        { "name": "Partner University" }
      ]
    },
    "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\"}"
  }
}

Sebelumnya: Identitas Digital

Berikutnya: Kemampuan Bahasa Inggris