Quick Start

Last updated: Oct 12th, 2020

Download

ผู้ที่จะสามารถใช้งาน KUCSC-API ได้ต้องเป็นนิสิต บุคลากรของมหาวิทยาลัยเกษตรศาสตร์ เท่านั้น และใช้เพื่อการศึกษาและสนับสนุนการพัฒนาระบบสารสนเทศโดยไม่มีผลประโยชน์หรือจุดประสงค์อื่นใดแอบแฝง

ผู้ใช้งานสามารถดาวน์โหลด Postman เครื่องมือในการทดสอบ API ได้ที่ https://www.postman.com/

Download Postman

Installation

Step One

Authen LDAP User ผู้ใช้งานจะต้องลงทะเบียนเพื่อขออนุญาตใช้งาน KUCSC-API โดยการ Login เข้าสู่ระบบ https://inv.csc.ku.ac.th/api และต้องได้รับอนุมัติก่อนการใช้งานจริง

สถานะการยืนยันตัวตน: ยังไม่ยืนยัน

Application key

KUCSC-API ให้ผู้ใช้งานสามารถสร้าง Application key ได้ด้วยตนเองเพื่อแยกใช้งานในแต่ละแอบพลิเคชั่นได้

You are Application key: Create Key
Setting Application name Application key

Step Three

ให้นำ key application ที่ได้นำ ไปใช้เพื่อดึงข้อมูลจาก KUCSC-API. ตามรูปแบบโครงสร้างที่กำหนด ดังตัวอย่างการใช้งาน key application ดังนี้

Postman Example

            URL : https://inv.csc.ku.ac.th/cscapi/student/hello.php
            Method : GET                                           
            body : {
                "keyapp" : "key application",
                "dataset" : "hello"               

            }
Result Example

{
    "status_code": "1000",
    "data": {
        "appName": "project-test1-app5",
        "keyApp": "key application",
        "status": "อนุมัติ",
        "created": "2021-12-07 13:58:03",
        "dataset": "hello"
    }
}

Code Javascript

สามารถดาวน์โหลด https://jquery.com โดยใช้เวอร์ชั่น 3.4.1 หรือมากกว่า และดาวน์โหลดได้ที่ bootstrap

HTML Code Example

<!DOCTYPE html> 
<html lang="en"> 
<script type="text/javascript" src="assets/plugins/jquery-3.4.1.min.js" > </script>
<script type="text/javascript" src="assets/plugins/bootstrap/js/bootstrap.min.js" > </script>
      
    ...
    <div id="showdata"> 
       
    </div>
   
    ...
</html>
JavaScript Example

    $( document ).ready(function() {    
            
            var settings = {
                "url": "https://inv.csc.ku.ac.th/cscapi/student/hello.php",
                "method": "GET",
                "timeout": 0,
                "headers": {
                    "Content-Type": "application/json"
                },
                "data": JSON.stringify({
                    "keyapp": "key application",
                    "dataset": "hello"
                   
                }),
                };

                $.ajax(settings).done(function (response) {
                    // console.log(response.data);
                    $('#showdata').html(JSON.stringify(response.data));
                });
        });
JavaScript call student api
<script> 
        $( document ).ready(function() {    
            
            var settings = {
                "url": "https://inv.csc.ku.ac.th/cscapi/student/api.php",
                "method": "GET",
                "timeout": 0,
                "headers": {
                    "Content-Type": "application/json"
                },
                "data": JSON.stringify({
                    "keyapp": "key application",
                    "dataset": "student",
                    "STD_ID": "รหัสนิสิต", // หากต้องการข้อมูลนิสิตทั้งคณะไม่ต้องระบุ STD_ID
                    "FAC_ID": "B", // รหัสคณะ A=ทอ., B=วว., C=ศว.,D=สศ.
                    "YR": "65", // ปีที่ต้องการข้อมูล เช่น นิสิตรหัส 65,64
                    "STATUS_CODE": "G" // G=จบการศึกษา, S=กำลังศึกษา, D= ลาพักการศึกษา,R=พ้นสภาพการเป็นนิสิต ไม่ระบุจะคืนค่าเป็นข้อมูลนิสิตที่เป็น Sและ D กลับมา

                   
                }),
                };

                $.ajax(settings).done(function (response) {
                    //console.log(response.data.appName);
                    $('#showdata').html(JSON.stringify(response.data));
                });
        });    
</script>
JavaScript call Advisor api
<script> 
        $( document ).ready(function() {    
            
            var settings = {
                "url": "https://inv.csc.ku.ac.th/cscapi/student/api.php",
                "method": "GET",
                "timeout": 0,
                "headers": {
                    "Content-Type": "application/json"
                },
                "data": JSON.stringify({
                    "keyapp": "key application",
                    "dataset": "advisor", 
                    "ADVISOR_ID": "รหัสอาจารย์ที่ปรึกษา",                
                    "FAC_ID": "B" // รหัสคณะ   
                   
                }),
                };

                $.ajax(settings).done(function (response) {
                    //console.log(response.data.appName);
                    $('#showdata').html(JSON.stringify(response.data));
                });
        });    
</script>
JavaScript call Course open api
<script> 
                                        $( document ).ready(function() {    
            
            var settings = {
                "url": "https://inv.csc.ku.ac.th/cscapi/student/api.php",
                "method": "GET",
                "timeout": 0,
                "headers": {
                    "Content-Type": "application/json"
                },
                "data": JSON.stringify({
                    "keyapp": "key application",
                    "dataset": "advisor", 
                    "YR": "ปีการศึกษา 6x",                
                    "SM": "ภาคการศึกษา เช่น 1=ภาคต้น,2=ภาคปลาย,0=ภาคฤดูร้อน" ,                    
                    "CS_CODE": "รหัสวิชา",
                    "FAC_ID": "รหัสคณะ (A=ทอ, B=วว, C=ศว, D=ศส)"
                   
                }),
                };

                $.ajax(settings).done(function (response) {
                    //console.log(response.data.appName);
                    $('#showdata').html(JSON.stringify(response.data));
                });
        });  
</script>
JavaScript call Course Register api
<script> 
$( document ).ready(function() {    
            
            var settings = {
                "url": "https://inv.csc.ku.ac.th/cscapi/student/api.php",
                "method": "GET",
                "timeout": 0,
                "headers": {
                    "Content-Type": "application/json"
                },
                "data": JSON.stringify({
                    "keyapp": "key application",
                    "dataset" : "regcourse",
                    "fac_id" : "รหัสคณะ A=ทอ,B=วว,C=ศว,D=ศส", //(ต้องระบุ)
                    "cs_code" : "รหัสวิชา",
                    "stdid" : "รหัสนิสิต" ,
                    "yr" : "ปีการศึกษา", // 64,65,..
                    "sm" : "ภาคการศึกษา" // 1=ภาคต้น,2=ภาคปลาย,0=ภาคฤดูร้อน
                   
                }),
                };

                $.ajax(settings).done(function (response) {
                    //console.log(response.data.appName);
                    $('#showdata').html(JSON.stringify(response.data));
                });
        });  
</script>
JavaScript call schedule api
<script> 
                                        $( document ).ready(function() {    
            
            var settings = {
                "url": "https://inv.csc.ku.ac.th/cscapi/student/api.php",
                "method": "GET",
                "timeout": 0,
                "headers": {
                    "Content-Type": "application/json"
                },
                "data": JSON.stringify({
                    "keyapp": "",  //keyappliaction 
                    "dataset" : "schedule",                  
                    "fac_id": "B" ,             // รหัสคณะ (ไม่บังคับ)
                    "cs_code": "03626597",     // รหัสวิชา (ไม่บังคับ)
                    "yr": "67",                // ปีการศึกษา (พ.ศ. 2 หลักสุดท้าย)
                    "sm": "2"                  // ภาคการศึกษา (1= ภาคต้น, 2=ภาคปลาย, 0=ภาคฤดูร้อน)
                })
                };

                $.ajax(settings).done(function (response) {
                    //var data = JSON.stringify(response.data);
                    $('#showdata').html(JSON.stringify(response));
                 
                });
        });  
</script>
JavaScript call LDAP api
<script> 
                                        $( document ).ready(function() {    
            
            var settings = {
                "url": "https://inv.csc.ku.ac.th/cscapi/ldap/",
                "method": "GET",
                "timeout": 0,
                "headers": {
                    "Content-Type": "application/json"
                },
                "data": JSON.stringify({
                    "keyapp": "",  //keyappliaction 
                    "dataset" : "ldap",
                    "userid" : "",  //user ldap
                    "pwd" : ""      //password for ldap
                })
                };

                $.ajax(settings).done(function (response) {
                    //var data = JSON.stringify(response.data);
                    $('#showdata').html(JSON.stringify(response));
                 
                });
        });  
</script>

DataSet

Dataset คือ ชื่อชุดข้อมูลที่ให้บริการ เช่น ข้อมูลนิสิต ข้อมูลการลงทะเบียนเรียน ข้อมูลนิสิต ข้อมูลคณะ ข้อมูลอาจารย์ที่ปรึกษา

ข้อมูลนิสิต Dataset name : student
parameter name parameter value description
FAC_ID (A/B/C/D/F/X) หากส่งเป็น F ให้แสดงข้อมูลนิสิตทั้งหมดในวิทยาเขต นอกนั้นให้แสดงเฉพาะคณะที่ร้องขอไปเท่านั้น
STD_ID (63XXXXXXXX) ใช้สำหรับร้องขอข้อมูลเฉพาะนิสิตรหัสนั้น ๆ
STATUS_CODE S,D,G,R // G=จบการศึกษา, S=กำลังศึกษา, D= ลาพักการศึกษา,R=พ้นสภาพการเป็นนิสิต ไม่ระบุจะคืนค่าเป็นข้อมูลนิสิตที่เป็น S และ D กลับมา
data(ข้อมูลที่ตอบกลับ) - STD_ID
- P_ID
- PRE_TNAME
- T_NAME
- T_SURNAME
- ADVISOR_ID
- DEP_ID
- MAJOR_ID
- DEPT_ID
- FAC_ID
- STATUS_CODE












- MAIL
- PHONE
- ADDR
- TAMBON
- AMPHUR
- PROVINCE
 - รหัสนิสิต
- เลขที่บัตรประชาชน
- คำนำหน้าชื่อภาษาไทย
- ชื่อ
- นามสกุล
- รหัสอาจารย์ที่ปรึกษา
- DEP_ID(null)
- รหัสสาขาวิชา
- DEPT_ID(null)
- รหัสคณะ
- รหัสสถานะภาพนิสิต
S กำลังศึกษา
T ลาออก
R คัดชื่อออก
G จบการศึกษา
A ถึงแก่กรรม
D พักการศึกษา
M โอนย้าย
U ไม่รายงานตัวเข้าศึกษา
W ติดต่อไม่ได้
Q ย้ายโครงการ
B เรียนข้ามวิทยาเขต
O ย้ายคณะ
- อีเมล์
- เบอร์โทรศัพท์
- ที่อยู่
- ตำบล
- อำเภอ
- จังหวัด
ข้อมูลอาจารย์ที่ปรึกษา (Advisor) Dataset name : advisor
parameter name parameter value description
FAC_ID (A/B/C/D/F/X) หากส่งเป็น F จะ return ข้อมูลอาจารย์ที่ปรึกษาทั้งหมดในวิทยาเขต
data(ข้อมูลที่ตอบกลับ) - ADVISOR_ID
- T_NAME
- T_SURNAME
- E_NAME
- E_SURNAME
- EMAIL		 - รหัสอาจารย์ที่ปรึกษา
- ชื่อ(ภาษาไทย)
- นามสกุล(ภาษาไทย)
- ชื่อ(ภาษาอังกฤษ)
- นามสกุล(ภาษาอังกฤษ)
- อีเมล
ข้อมูลรายวิชาที่เปิดสอน (Course open) Dataset name : course
parameter name parameter value description
YR 6X (เช่น 61,62,...) ข้อมูลปีการศึกษาที่เปิดสอนรายวิชา (ต้องระบุ)
SM 1 = ภาคต้น
2 = ภาคปลาย
0 = ภาคฤดูร้อน
ข้อมูลภาคการศึกษาที่เปิดสอนรายวิชา (ต้องระบุ)
CS_CODE (0XXXXXXX) รหัสวิชา
FAC_ID A,B,C,D รหัสคณะ (ต้องระบุ)
data(ข้อมูลที่ตอบกลับ) - YR
- SM
- CS_CODE
- T_NAME
- E_NAME
- TT_CREDIT		 - ปีการศึกษาที่เปิดสอนรายวิชา
- ภาคการศึกษาที่เปิดสอนรายวิชา
- รหัสวิชา
- ชื่อวิชา(ภาษาไทย)
- ชื่อวิชา(ภาษาอังกฤษ)
- หน่วยกิตรวม
ข้อมูลลงทะเบียนเรียน (Course register) Dataset name : regcourse
parameter name parameter value description
รหัสคณะ A,B,C,D รหัสคณะ
cs_code (0XXXXXXX) รหัสวิชา
stdid 65xxxxxxxx รหัสนิสิต
yr 6X (เช่น 61,62,...) ข้อมูลปีการศึกษาที่เปิดสอนรายวิชา
sm 1 = ภาคต้น
2 = ภาคปลาย
0 = ภาคฤดูร้อน
ข้อมูลภาคการศึกษาที่เปิดสอนรายวิชา
data(ข้อมูลที่ตอบกลับ) - std_id
- pre_tname
- t_name
- t_surname
- yr
- sm
- cs_code
- course_tname
- section
- rg_type
- grade
- fac_id
- facname
 - รหัสนิสิต
- คำนำหน้าชื่อนิสิต
- ชื่อ
- นามสกุล
- ปีการศึกษา
- ภาคการศึกษา
- รหัสวิชา
- ชื่อวิชา
- หมู่เรียน
- ประเภทการลงทะเบียน
- ผลการเรียน (N=ยังไม่มีผลการเรียน)
- รหัสคณะ
- ชื่อคณะ
ข้อมูลตารางเรียน (Schedule) Dataset name : schedule
parameter name parameter value description
fac_id (A/B/C/D/F/X) หากต้องการข้อมูลทั้งหมดในวิทยาเขต ให้ใส่เป็นค่าว่าง
cs_code (รหัสวิชา) ใช้สำหรับร้องขอข้อมูลเฉพาะวิชาที่ต้องการนั้น ๆ
yr ปีการศึกษา 65,66,67,.. เลข 2 หลักสุดท้ายของ ปี พ.ศ.
sm ภาคการศึกษา 1,2,0 เลข 2 หลักสุดท้ายของ ปี พ.ศ.
data(ข้อมูลที่ตอบกลับ) - yr
- sm
- building_no
- room_no
- room_floor
- room_name
- quota
- cs_code
- map_year
- t_name
- cs_own
- major_name
- fac_name
- section
- time_table
- time_start
- time_end
- cnt_reg
- quota_all
- teacher_id
- teacher_name
 - ปีการศึกษา
- ภาคการศึกษา
- ชื่ออาคารเรียน
- หมายเลขห้องเรียน
- หมายเลขชั้นเรียน
- ชื่อห้องเรียน
- จำนวนที่นั่งห้องเรียน
- รหัสวิชา
- ปีรายวิชา
- ชื่อวิชา
- รหัสเจ้าของรายวิชา
- ชื่อภาควิชา
- คณะเจ้าของรายวิชา
- หมู่เรียน
- วันเรียน (จัททร์ - อาทิตย์/ Mon-Sun)
- เวลาเริ่มเรียน
- เวลาเลิกเรียน
- จำนวนนิสิตที่ลงทะเบียน
- จำนวนเปิดรับลงทะเบียน
- รหัสอาจารย์ผู้สอน
- ชื่ออาจารย์ผู้สอน
KUCSC-API