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

ความเชี่ยวชาญภาษาอังกฤษ

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

Info
สำคัญ: กรุณาตรวจสอบให้แน่ใจว่าไฟล์อยู่ในรูปแบบ 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.
  }
}

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

คู่คีย์-ค่า CEFR แบบละเอียดมีความสำคัญต่อการแสดงเอกสารรับรองความสามารถทางภาษาอังกฤษบนแพลตฟอร์ม SEEK การระบุคะแนน CEFR สำหรับ Combined (combined หมายถึงระดับทักษะภาษาอังกฤษโดยรวมของแต่ละบุคคล), Reading (reading), Listening (listening), Speaking (speaking) และ/หรือ Writing (writing) ช่วยให้เราสามารถแสดงความสามารถทางภาษาอังกฤษของผู้ใช้ได้อย่างละเอียดและสอดคล้องกัน

กรณีการใช้งาน

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.

คะแนน CEFR ที่รองรับ

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

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

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

ตัวอย่าง payload

ตัวอย่างการประเมินการพูด

{
  "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"
  }
}

ตัวอย่างรายงานสรุป

{
  "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"
  }
}