Memulai
Sumber daya inti
Lainnya

Kemampuan Bahasa Inggris

Caution
Kemampuan Bahasa Inggris tersedia melalui API versi 1 dan 2. API versi 1 dijadwalkan untuk dihentikan penggunaannya di masa mendatang dan tidak boleh digunakan untuk integrasi baru. Integrasi baru harus menargetkan API versi 2.
Info
Permintaan API memerlukan cakupan OAuth write.english_proficiency.

Deskripsi kolom

Lihat Spesifikasi OpenAPI V1 untuk skema lengkap (termasuk bidang opsional).
Info
Penting: Pastikan file berformat PDF.
{
  "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 untuk bagaimana kredensial kemampuan bahasa Inggris ditampilkan di platform SEEK. Dengan mencakup skor CEFR untuk Gabungan (combined, mengacu pada tingkat keterampilan bahasa Inggris individu secara keseluruhan), Membaca (reading), Mendengarkan (listening), Berbicara (speaking) dan/atau Menulis (writing) kami dapat menampilkan kemampuan bahasa Inggris pengguna secara terperinci dan konsisten.

Kasus penggunaan

Sebagai contoh, ketika kandidat menjawab pertanyaan persyaratan peran dari perekrut tentang kemampuan bahasa Inggris, mereka dapat memilih opsi seperti "Berbicara dengan fasih dalam lingkungan profesional". Dengan memiliki skor di bawah Gabungan (combined) atau Berbicara (speaking), kami dapat menyoroti kemampuan kandidat terkait pertanyaan ini.

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