| Method | Path | Mục đích | Status |
|---|
| GET/POST · POST/DELETE · POST | /v3/crm/customers/{id}/learners · .../learners/{link_id} · .../set-primary | Liệt kê, tạo, gỡ liên kết khách hàng với người học; đặt người học chính | existing |
| GET | /v3/crm/customers/learners/search | Tìm hồ sơ người học để liên kết | existing |
| GET/PUT/DELETE | /v3/school/classes/{id}/lms-link | Xem; tạo hoặc liên kết ({flyer_class_id} | {create: true, teacher_profile_id}); tách. PUT trả 409 khi lớp FLYER đã được ánh xạ nơi khác | new |
| POST | /v3/school/classes/{id}/lms-link/sync | Đồng bộ danh sách ngay → {added, removed, pending, external} | new |
| GET | /v3/school/lessons/{lesson_id}/suggested-assign-tests | Bài tập FLYER gợi ý cho một bài học (PRD 14) | new |
| GET/POST | /v3/school/classes/{id}/homework | Danh sách; tạo {lesson_id, session_id?, assign_test_ids[], due_at, audience, student_ids?, grade_into_assessment, reminder_offsets_hours?} → tạo assign-test trên FLYER rồi ghi bản ghi homework | new |
| GET/PATCH/DELETE · POST | /v3/school/homework/{id} · /remind | Chi tiết kèm kết quả từng học viên; gia hạn {due_at, reason}; thu hồi; nhắc ngay học viên chưa nộp (lớp gửi tin PRD 07) | new |
| GET | /v3/teacher/classes/{class_id}/assign-tests · /v3/teacher/viewer/rollup-assign-tests · /v3/teacher/assign-tests/{assign_test_id}/analytics/question-analysis | Nguồn trạng thái nộp cho bộ đồng bộ; màn hình giáo viên; liên kết phân tích theo câu hỏi | existing |
| GET/POST | /v3/teacher/exams và đường dẫn con | Chọn đề thi cho kỳ đánh giá (PRD 13) | existing |
| GET | /v3/learner/attempts/{id}/report · /v3/parent/learner/{id}/weekly-report · /report | Báo cáo lượt làm bài; nguồn thời lượng học, kỹ năng, hoạt động | existing |
| GET | /v3/school/students/{id}/learning | Tổng hợp cho tab Học tập: hoạt động, bài tập, lượt thi, quyền truy cập (gộp từ các endpoint FLYER và bảng của Trường Số) | new |
| POST | /v3/school/homework/results/ingest | Điểm nhận webhook nộp bài từ FLYER (nếu được phát hành); bộ đồng bộ theo lịch là phương án dự phòng | new |
| GET/PUT | /v3/school/fee-plans/{id} | Thêm các trường của loại online_package | extend |
| GET/POST · POST | /v3/school/students/{id}/entitlements · /v3/school/entitlements/{id}/revoke · /pause · /resume · /retry | Liệt kê; cấp thủ công {fee_plan_id, starts_at, reason}; thu hồi, tạm dừng, tiếp tục, thử cấp lại; có lý do, ghi nhật ký. Danh mục sản phẩm FLYER bán được lấy từ /v3/school/online-products | new |
| GET | /v3/teacher/package/my-subscriptions | Kiểm tra quyền giao bài của giáo viên | existing |
| GET | /v3/learner/feature-configs | Phản ánh quyền truy cập của người học; bổ sung nguồn school_entitlement | extend |
| POST | /v3/parent/learner/{id}/sso-code | Phát hành mã trao đổi dùng một lần cho phụ huynh đã đăng nhập cổng | new |
| POST | /v3/learner/auth/exchange | Đổi mã thành phiên người học; 410 khi mã đã dùng hoặc hết hạn | new |
| GET | /v3/parent/learner/{id}/learning | Tổng hợp cho cổng phụ huynh: bài tập cần làm, tuần này, lượt thi, gói | new |
| GET | /v3/school/reports/elearning | school_id, from, to, group_by=class|student; format=xlsx | new |
| GET/PUT | /v3/teacher/school-config | Khối elearning_policy | extend |
| GET/POST/PATCH · POST · GET | /v3/school/courses · /{id}/publish · /{id}/certificates · /v3/public/certificates/{lookup_code} (P2) | Khoá học tự xây từ bài học PRD 14; xuất bản; cấp chứng chỉ; tra cứu công khai | new |
