Memulai
Sumber daya inti
Lainnya

Kemampuan Bahasa Inggris

Info
Kemampuan Bahasa Inggris 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.english_proficiency.

Deskripsi kolom

Info
Penting: Pastikan file berformat PDF.
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 "english_assessment"
  "credential_type": { "type": "string" }, // (Required) Must be "english_proficiency"
  "data": { // { "type": "object" }, (Required)
    "credential": { // { "type": "object" }, (Required)
      "full_name": { "type": "string" }, // (Required)
      "test_provider": { "type": "string" }, // (Required)
      "test_name": { "type": "string" }, // (Required)
      "completion_date": { "type": "string" }, // (Required) Date format: "YYYY-MM-DD"
      "expiry_date": { "type": "string" }, // (Optional) Date format: "YYYY-MM-DD"
      "test_scores": { // { "type": "object" }, (Required)
        "cefr_scores": { // { "type": "object" }, (Required)
          "combined": "string", { "type": "string" }, // (Optional), Combined CEFR score across all other skills
          "reading": "string", { "type": "string" }, // (Optional), CEFR score for Reading
          "listening": "string", { "type": "string" }, // (Optional), CEFR score for Listening
          "speaking": "string", { "type": "string" }, // (Optional), CEFR score for Speaking
          "writing": "string" { "type": "string" }, // (Optional), CEFR score for Writing
        },
        "overall": { // { "type": "object" }, (Required)
          "score": { "type": "string" }, // (Required)
          "scale": { "type": "string" }, // (Required)
        },
        "subskills": [ // { "type": "array" }, (Optional)
          {
            "skill": { "type": "string" }, // (Required)
            "score": { "type": "string" }, // (Required)
          }
        ],
        "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, or null if not applicable.
  }
}

Memanfaatkan kolom Bahasa Inggris

Pasangan nilai kunci CEFR yang terperinci penting bagi cara kredensial kemahiran bahasa Inggris ditampilkan di platform SEEK. Dengan menyertakan skor CEFR untuk Gabungan (gabungan, mengacu pada tingkat kemampuan bahasa Inggris seseorang secara keseluruhan), Membaca (membaca), Mendengarkan (mendengarkan), Berbicara (berbicara) dan/atau Menulis (menulis), kami dapat menampilkan kemahiran bahasa Inggris pengguna secara terperinci dan konsisten.

Kasus penggunaan

For example, when candidates respond to hirer role requirement questions about English proficiency, they are able to select options such as "Speaks proficiently in a professional setting". By having a score under Combined (combined) or Speaking (speaking), we are able to highlight a candidate's proficiency in relation to this question.

Skor CEFR yang didukung

The API accepts the following CEFR score values for all CEFR score fields. API field names are English identifiers:
combined, reading, listening, speaking, writing
  • BELOW_A1
  • A1
  • A2
  • B1
  • B2
  • C1
  • C2

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 penilaian berbicara

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "document_type": "english_assessment",
  "credential_type": "english_proficiency",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "test_provider": "EnglishTestProvider",
      "test_name": "EnglishTestProvider Speaking",
      "completion_date": "2024-08-31",
      "expiry_date": "2026-08-31",
      "test_scores": {
        "cefr_scores": {
          "speaking": "A1"
        },
        "overall": {
          "score": "150",
          "scale": "EnglishTestProvider"
        },
        "subskills": [
          {
            "skill": "Communication",
            "score": "50"
          },
          {
            "skill": "Fluency",
            "score": "50"
          },
          {
            "skill": "Pronunciation",
            "score": "50"
          }
        ]
      }
    },
    "document": "https://example.com/certificate.pdf"
  }
}

Contoh laporan ringkasan

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "document_type": "english_assessment",
  "credential_type": "english_proficiency",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "test_provider": "EnglishTestProvider",
      "test_name": "EnglishTestProvider Certificate Summary Report",
      "completion_date": "2024-08-31",
      "expiry_date": "2026-08-31",
      "test_scores": {
        "cefr_scores": {
          "combined": "A1",
          "speaking": "B1",
          "listening": "C1",
          "reading": "B2",
          "writing": "C2"
        },
        "overall": {
          "score": "415",
          "scale": "EnglishTestProvider"
        },
        "subskills": [
          {
            "skill": "Core Skills",
            "score": "401"
          },
          {
            "skill": "Speaking",
            "score": "406"
          },
          {
            "skill": "Writing",
            "score": "466"
          }
        ]
      }
    },
    "document": "https://example.com/certificate.pdf"
  }
}
ChevronSebelumnya: Pendidikan
Berikutnya: Pembelajaran dan Pengembangan (Mikrokredensial)Chevron