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

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

คำขอ ความเชี่ยวชาญภาษาอังกฤษ ควรใช้ API เวอร์ชัน 2 API เวอร์ชัน 1 ถูกเลิกใช้แล้ว และพาร์ทเนอร์ต้องย้ายการเชื่อมต่อที่มีอยู่ การเชื่อมต่อใหม่ต้องใช้ API เวอร์ชัน 2 กำหนดเวลาการย้ายคือ TBA ดูคู่มือการย้ายและใช้ API เวอร์ชัน 2.
คำขอ API ต้องใช้ OAuth scope write.english_proficiency ดูที่ OAuth authentication

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

ดู OpenAPI Specification V2 สำหรับสคีมาแบบเต็ม (รวมถึงฟิลด์ที่ไม่บังคับ)
สำคัญ: กรุณาตรวจสอบให้แน่ใจว่าไฟล์อยู่ในรูปแบบ PDF
{
  "credential_id": { "type": "string" }, // (Required) Unique identifier for the credential
  "fields": { // { "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", "null"] }, // (Optional) Date format: "YYYY-MM-DD"
    "test_scores": { // { "type": "object" }, (Required)
      "cefr_scores": { // { "type": "object" }, (Required) At least one of combined, listening, reading, speaking, or writing
        "combined": { "type": ["string", "null"] }, // Combined CEFR score across all other skills
        "reading": { "type": ["string", "null"] }, // CEFR score for Reading
        "listening": { "type": ["string", "null"] }, // CEFR score for Listening
        "speaking": { "type": ["string", "null"] }, // CEFR score for Speaking
        "writing": { "type": ["string", "null"] } // CEFR score for Writing
      },
      "overall": { // { "type": "object" }, (Required)
        "score": { "type": "string" }, // (Required)
        "scale": { "type": "string" } // (Required)
      },
      "subskills": [ // { "type": ["array", "null"] }, (Optional)
        {
          "skill": { "type": "string" }, // (Required)
          "score": { "type": "string" } // (Required)
        }
      ]
    },
    "partner_chain": { "type": ["array", "null"] } // (Optional) e.g. [{ "name": "Partner Organization" }]
  },
  "assets": [ // { "type": ["array", "null"] }, (Optional)
    {
      "asset_id": { "type": "string" }, // (Required)
      "asset_type": { "type": "string" }, // (Required) "pdf"
      "asset_data": { "type": ["string", "null"] } // URL pointing to a PDF document
    }
  ]
}

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

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

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

ตัวอย่างเช่น เมื่อผู้สมัครตอบคำถามเกี่ยวกับข้อกำหนดของตำแหน่งงานจากผู้ประกอบการเกี่ยวกับความสามารถทางภาษาอังกฤษ พวกเขาสามารถเลือกตัวเลือกเช่น "พูดได้อย่างเชี่ยวชาญในสภาพแวดล้อมการทำงาน" การมีคะแนนในส่วน รวม (combined) หรือ การพูด (speaking) จะช่วยให้เราสามารถเน้นย้ำความสามารถของผู้สมัครที่เกี่ยวข้องกับคำถามนี้ได้

คะแนน 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

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

{
  "credential_id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "fields": {
    "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"
        }
      ]
    }
  },
  "assets": [
    {
      "asset_id": "assessment-pdf-1",
      "asset_type": "pdf",
      "asset_data": "https://example.com/certificate.pdf"
    }
  ]
}

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

{
  "credential_id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "fields": {
    "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"
        }
      ]
    }
  },
  "assets": [
    {
      "asset_id": "summary-pdf-1",
      "asset_type": "pdf",
      "asset_data": "https://example.com/certificate.pdf"
    }
  ]
}