The system is soon moving from Single to Multiple Course Enrollment. Necessary updates in the Rest API data were made in order to synchronize with the new feature.
This article guides you on the API updates required to be implemented for successful integration to work. This document is specially meant for developers concerned with linking Classe365 data with third party suppliers.
1) Authentication
API Documentation: https://speca.io/classe365/academics#authentication_group
For authentication, we use basic HTTP authentication. So you need to pass base64 encoded string of “<tenant_name>:<api_key>” in credentials.
You can generate the API key from our Web App’s Admin Panel > Settings > APIs page.
CURL Command Example
curl … “Authorization: Basic <base64 encoded string of tenant_name:api_key” …
PHP CURL Example
$auth_token = base64_encode("<tenant_name>:<api_key>");
$headers = array(“Content-type:application/json”, "Authorization: Basic ".$auth_token );
$ch = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
2) Academics
The set of APIs in this section allow you to create and update departments, classes, subjects.
API Documentation Link | Type | Endpoint URL |
POST | /rest/academic | |
POST | /rest/academic | |
POST | /rest/academic | |
POST | /rest/academic | |
GET | /rest/getAcademicDataForParticular | |
GET | /rest/getAcademicDataForAll |
3) Academic Sessions
This API allows you to get the data of all unlocked academic sessions.
API Documentation: https://speca.io/classe365/academics#get-academic-sessions
Example:
curl -X GET "https://evaluate3x.classe365.com/rest/academicSessions" H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
4) Teachers and Admin Staff
This group contains the API documentation related to teachers and admin staff information.
API Documentation Link | Type | Endpoint URL |
POST | /rest/teacher | |
GET | /rest/teachersData | |
POST | /rest/admin | |
GET | /rest/adminsData |
Example:
To Insert Teacher
curl -X POST "https://evaluate3x.classe365.com/rest/teacher" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm" -d 'data={"teacher_id":"2016_1_apinew","first_name":"Cary","last_name":"Baxter","teacher_dob":"1991-05-11","teacher_email":"[email protected]","teacher_contact":"12972565652","is_academic":1,"image": "data:image/png;base64,BASE64CODE"}'To Update Teacher
curl -X POST "https://evaluate3x.classe365.com/rest/teacher" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm" -d 'data={"id":8,"teacher_id":"2019","first_name":"Cary","last_name":"Baxter","teacher_dob":"1992-05-11","teacher_email":"[email protected]","teacher_contact":"12972565652","is_academic":1,"image": "data:image/png;base64,BASE64CODE"}'
5) Students
This group contains the API documentation related to students insert and update actions.
The following data variables in the response data will be removed - Class/Section/Subject.
A new data variable, called "Enrollments" will be added.
API Documentation Link | Type | Endpoint URL |
POST | /rest/student | |
POST | /rest/studentCourseEnroll | |
POST | /rest/electiveSubjectsAllocation | |
POST | /rest/studentSubjectStatusUpdate | |
GET | /rest/getTotalStudentCount | |
GET | /rest/studentsData | |
POST | /rest/studentStatusUpdate | |
GET | /rest/studentAttributes |
Example:
Add Student
curl -X POST "https://evaluate3x.classe365.com/rest/student" \ -H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm" \ -d 'data={"admission_number":"2016_1_api","first_name":"Classe","last_name":"Developer","student_dob":"2000-05-08","student_email":"[email protected]","student_contact":"123123123","gender":"Male","father_name":"Johnson","mother_name":"Scarlett","parents_contact":"11111111","parents_email":"[email protected]"}'
Update Student
curl -X POST "https://evaluate3x.classe365.com/rest/student" \ -H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm" \ -d 'data={"id":"19","admission_number":"2016_1_api","first_name":"Stephen","last_name":"hawking","student_dob":"2000-05-08","student_email":"[email protected]","student_contact":"123123123","gender":"Male","father_name":"Johnson","mother_name":"Scarlett","parents_contact":"11111111","parents_email":"[email protected]"}'
6) Attendance
This group lists the API documentation for attendance.
API Documentation Link | Type | Endpoint URL |
POST | /rest/manageAttendance | |
GET | /rest/attendanceData | |
GET | /rest/allAttendanceByDate | |
GET | /rest/attendanceByDateInLV | |
GET | /rest/attendanceSettings |
Example
Save Attendance
curl -X POST "https://evaluate3x.classe365.com/rest/manageAttendance" \ -H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm" \ -d 'acds_id=1&class_id=1§ion_id=1&subject_id=1&session_id=6&date=2019-11-27&working=1&attendance_data={"2":{"status":"p","comment":""},"4":{"status":"a","comment":""},"5":{"status":"a","comment":""},"6":{"status":"a","comment":""},"9":{"status":"p","comment":""},"10":{"status":"p","comment":""},"12":{"status":"p","comment":""}}'
GET Attendance Data
curl -X GET "https://evaluate3x.classe365.com/rest/attendanceData?acds_id=1&class_id=1§ion_id=1&date=2019-11-08&subject_id=1&session_id=6" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
GET Attendance Data for All Students and a Particular Date
curl -X GET "https://evaluate3x.classe365.com/rest/allAttendanceByDate?acds_id=1&date=2019-11-07" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
Get Attendance Data for All Students and Particular Date in Linear View
curl -X GET "https://evaluate3x.classe365.com/rest/attendanceByDateInLV?acds_id=1&date=2020-01-13" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
Get Attendance Settings
curl -X GET "https://evaluate3x.classe365.com/rest/attendanceSettings?acds_id=1" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
7) Grading and Assessments
This section lists the API documentation for the APIs related to grading and assessments.
API Documentation Link | Type | Endpoint URL |
GET | /rest/studentScore | |
GET | /rest/studentsScore | |
GET | /rest/subjectScore | |
POST | /rest/saveAssessmentScore | |
GET | /rest/getAssessments |
Example:
Get Assessments Score for a Student
curl -X GET "https://evaluate3x.classe365.com/rest/studentScore?id=2&acds_id=1" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
Get Assessments Score for Multiple Students
curl -X GET "https://evaluate3x.classe365.com/rest/studentsScore?recordsPerPage=10&pageNo=2&acds_id=1" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
Get Assessments Score for a Subject
curl -X GET "https://evaluate3x.classe365.com/rest/subjectScore?id=1&acds_id=1" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
Add or Update Assessment Score
curl -X POST "https://evaluate3x.classe365.com/rest/saveAssessmentScore" -H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm" -d 'acds_id=1&assessment_id=1&subject_id=1&score_data={"4":{"score":"20","comment":"Good","status":""},"2":{"score":"10","comment":"Poor Performance","status":""},"6":{"score":"","comment":"","status":"EXE"}}'
Get Assessments
curl -X GET "https://evaluate3x.classe365.com/rest/getAssessments?acds_id=1" -H -H "Content-Type: application/json" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
8) Invoicing and Payments
This section lists the API documentation for the APIs related to invoicing and payments.
API Documentation Link | Type | Endpoint URL |
GET | /rest/feesInfo | |
GET | /rest/feeInvoicesData | |
POST | /rest/createInvoice | |
POST | /rest/createUpdatePayment |
Example
Get data for particular fees category using fee_id.
curl -X POST "https://demo.classe365.com/rest/feesInfo?fee_id=1&format=json" -H -H "Content-Type: application/json" -H "Authorization: Basic ZGVtbzorQENlOUx6Unl3YjVtNXE2"
Get data for particular invoice using invoice_id.
curl -X POST "https://demo.classe365.com/rest/feesInfo?invoice_id=1&format=json" -H -H "Content-Type: application/json" -H "Authorization: Basic ZGVtbzorQENlOUx6Unl3YjVtNXE2"
Get data for particular payment using payment_id.
curl -X POST "https://demo.classe365.com/rest/feesInfo?payment_id=1&format=json" -H -H "Content-Type: application/json" -H "Authorization: Basic ZGVtbzorQENlOUx6Unl3YjVtNXE2"
Get data for all fees category.
curl -X POST "https://demo.classe365.com/rest/feesInfo?format=json" -H -H "Content-Type: application/json" -H "Authorization: Basic ZGVtbzorQENlOUx6Unl3YjVtNXE2"
9) Finance & Accounting
This API allows you to get ledger accounts data.
API Documentation Link | Type | Endpoint URL |
GET | /rest/ledgerAccounts | |
GET | /rest/accountEntries |
Example:
Get Ledger Accounts Data
curl -X GET "https://demo.classe365.com/rest/accountEntries?account_id=fy2021&page=1&from_date=2023-04-01&to_date=2023-04-30" \
-H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZGVtbzorQENlOUx6Unl3YjVtNXE2"
Get Account Entries Data
curl -X GET "https://demo.classe365.com/rest/accountEntries?account_id=fy2021&page=1&from_date=2023-04-01&to_date=2023-04-30" \
-H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZGVtbzorQENlOUx6Unl3YjVtNXE2"
10) CRM-Enroll & Forms
This API allows you to add a submission, retrieve form details and retrieve the submissions data or update existing submission details.
API Documentation Link | Type | Endpoint URL |
POST | /rest/formSubmit | |
GET | /rest/getSubmission | |
GET | /rest/getSubmissionsData |
Example
Get Submissions Data
curl -X GET "https://demo.classe365.com/rest/getSubmissionsData?page={"recordsPerPage":"10","pageNo":"1"}" \
-H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZGVtbzorQENlOUx6Unl3YjVtNXE2"Get Particular Submisssion
curl -X GET "https://demo.classe365.com/rest/getSubmissionsData?filter={"id":"4"}" \
-H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZGVtbzorQENlOUx6Unl3YjVtNXE2"
11) Agents
This API allows you to add agent data or update existing agent data.
API Documentation Link | Type | Endpoint URL |
POST | /rest/agent | |
GET | /rest/agentsData |
Example
Get Agents Data
curl -X GET "https://evaluate3x.classe365.com/rest/agentsData?age={"recordsPerPage":"10","pageNo":"1"}" \ -H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"Get Particular Agent
curl -X GET "https://evaluate3x.classe365.com/rest/agentsData?filter={"id":"4"}" \
-H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm"
12) Tasks
This API allows you to add, and retrieve task data.
API Documentation Link | Type | Endpoint URL |
POST | /rest/saveTaskData | |
GET | /rest/tasksData |
Example
Add Task Data
curl -X POST "https://evaluate3x.classe365.com/rest/saveTaskData" \
-H -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic ZXZhbHVhdGUzeDpsY2g4Y0QqeFJqMzMwVmEm" \
-d 'data={"title":"Exam for monthly assessment", "description":"Description for task", "category_id":"Exam", "type":"todo", "start_date":"2024-07-01", "start_time":"12:00:00", "end_date":"2024-07-31", "end_time":"11:59:59", "status":"Pending", "priority":"high", "students":"2021_123,2021_163", "created_by":"3" }'
For more information or clarifications, just reach us at [email protected]
