Skip to main content
Version: Next

Báo cáo điểm danh​

1. Mô tả chung​

API này cho phép các trường liên kết với hệ thống GEdu gửi dữ liệu điểm danh hàng ngày lên Sở giáo dục. Dữ liệu bao gồm thông tin lớp học, số lượng học sinh đi học, nghỉ có phép, nghỉ không phép,... Hệ thống sẽ tiếp nhận và lưu trữ dữ liệu để phục vụ báo cáo và thống kê.

2. Phạm vi đối tượng sử dụng​

  • Các trường học, phòng giáo dục liên kết với GEdu.
  • Các hệ thống đối tác tích hợp như phần mềm quản lý học sinh, cổng thông tin giáo dục,...

3. Tài liệu api​

  • 3.1 Endpoint​

    POST /edu/v1/external/AttendanceBook/schools/{schoolCode}

  • 3.2 Parameters​

    TênVị tríKiểu dữ liệuBắt buộcMô tả
    schoolCodePathstringYesMã định danh của trường

  • 3.3 Request body​

    Dữ liệu sẽ được gửi hình thức json: application/json

    Request body
    {
      "attendDate": "2025-05-27T10:19:37.309Z",
      "attendanceBooks": [
        {
          "className": "Lớp 6A1",
          "totalStudent": 40,
          "totalAttend": 35,
          "totalAbsent": 5,
          "totalAbsentInvalid": 3,
          "totalAbsentValid": 2,
          "studyShiftsCode": "SA" //SA hoặc CH
        }
      ]
    }

  • 3.4 Responses​

      {
        "success": true,
        "message": "Thành công",
        "data": true,
        "showMessage": true,
        "statusCode": 200,
        "errors": [""],
        "meta": "string"
      }