Tapee University api.tapee.ac.thTapee API Gateway

Integration guide

คู่มือ API เทียบโอนและลงทะเบียนเรียน

แผนการเชื่อมต่อสำหรับระบบที่ได้รับอนุมัติ ครอบคลุมการเทียบโอน การเทียบโอนต่างสถาบัน และการลงทะเบียนรายวิชา

สถานะ: API การเทียบโอนจาก ปวส. เทียบโอนความรู้ เทียบโอนประสบการณ์ และเทียบโอนต่างสถาบันเปิดใช้งานสำหรับคีย์ที่ได้รับสิทธิ์เขียน ส่วน API ลงทะเบียนเรียนยังไม่เปิดใช้งานระหว่างตรวจขั้นตอนงานทะเบียน

Getting started

ขั้นตอนสำหรับระบบที่ต้องการเชื่อมต่อ

  1. ตกลงขอบเขตงานระบุระบบต้นทาง ผู้รับผิดชอบ และประเภทข้อมูลที่ได้รับอนุมัติให้บันทึก
  2. รับ API key สำหรับเขียนผู้ดูแลออกสิทธิ์แยกตามประเภทงาน และอาจจำกัด IP ของระบบที่เรียก
  3. ส่ง JSON ผ่าน HTTPSแนบ x-api-key ทุกคำขอ ตรวจ HTTP status และเก็บ requestId สำหรับติดตามผล
  4. ตรวจผลก่อนส่งซ้ำรายการเดิมตามคีย์จะได้รับ 409 Conflict เพื่อป้องกันการเพิ่มข้อมูลซ้ำ

Endpoints

ข้อมูลที่แต่ละ API รับและบันทึก

POST

/api/v1/transfer-grades

การเทียบโอนจาก ปวส., เทียบโอนความรู้, เทียบโอนประสบการณ์ รับปี ภาคเรียน รหัสนักศึกษา และรหัสวิชา ผลการเทียบโอนแสดงเป็น S เสมอ

สิทธิ์ที่ต้องมี: transfer-grades:write

POST

/api/v1/external-transfers

เทียบโอนต่างสถาบัน เพิ่มรหัสสถาบัน เกรด และวันที่เทียบโอน ระบบตรวจรหัสสถาบันและส่งชื่อสถาบันกลับ

สิทธิ์ที่ต้องมี: external-transfers:write

POST

/api/v1/registrations (ยังไม่เปิด)

ลงทะเบียนรายวิชา เพิ่มกลุ่มเรียน พร้อมตรวจเงื่อนไขงานทะเบียนก่อนบันทึก ขั้นตอนนี้ยังไม่เปิดใช้งานระหว่างตรวจผลกระทบกับตัวนับกลุ่มเรียนในระบบเดิม

สิทธิ์ที่วางแผน: registrations:write

การเทียบโอนไม่สร้างรายการลงทะเบียนเรียนโดยอัตโนมัติ การลงทะเบียนเป็นคำขอแยกต่างหาก

API สำหรับตาราง RegisterNet แยกจากหน้านี้: อ่านคู่มือ RegisterNet

Request examples

ตัวอย่างรูปแบบคำขอ

ตัวอย่างใช้ค่าแทนข้อมูลจริง API เทียบโอนเรียกได้เมื่อได้รับคีย์ที่มีสิทธิ์ ส่วนตัวอย่างลงทะเบียนยังเป็นร่าง

การเทียบโอนจาก ปวส., เทียบโอนความรู้, เทียบโอนประสบการณ์

POST /api/v1/transfer-grades
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "studentId": "STUDENT_ID",
  "year": "2569",
  "semester": "0",
  "courseCode": "COURSE_CODE"
}

เทียบโอนต่างสถาบัน

POST /api/v1/external-transfers
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "studentId": "STUDENT_ID",
  "year": "2569",
  "semester": "0",
  "courseCode": "COURSE_CODE",
  "universityId": "UNI_ID",
  "gradeCode": 3.0,
  "transferDate": "2026-10-02"
}

ลงทะเบียนเรียน

POST /api/v1/registrations
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "studentId": "STUDENT_ID",
  "year": "2569",
  "semester": "1",
  "courseCode": "COURSE_CODE",
  "section": "T1"
}

Responses

วิธีอ่านผลลัพธ์

201บันทึกรายการสำเร็จ
400ข้อมูลคำขอไม่ถูกต้อง
401 / 403ไม่มี API key หรือไม่มีสิทธิ์สำหรับงานนี้
404ไม่พบข้อมูลอ้างอิง เช่น นักศึกษา วิชา หรือสถาบัน
409มีรายการตามคีย์นี้อยู่แล้ว
HTTP/1.1 201 Created
{
  "requestId": "REQUEST_ID",
  "data": {
    "studentId": "STUDENT_ID",
    "year": "2569",
    "semester": "0",
    "courseCode": "COURSE_CODE",
    "grade": "S"
  }
}

หากยังไม่ได้รับสิทธิ์เขียน โปรดติดต่อผู้ดูแลระบบพร้อมระบุประเภทงานและ IP ของระบบที่จะเรียก