# VClasses

## Docs

- [VClasses API Authentication — Bearer Token Setup Guide](https://developer.vclasses.net/docs/api-reference/authentication.md): How to pass your Bearer token to authenticate every VClasses API request, including role requirements and error responses for auth failures.
- [VClasses API Error Responses — Status Codes and Messages](https://developer.vclasses.net/docs/api-reference/errors.md): Complete reference for VClasses API error responses — HTTP status codes, JSON envelope shape, 403 message variants, and validation error field messages.
- [GET /api/v3/admin/homeworks/{id} — Get Homework Details](https://developer.vclasses.net/docs/api-reference/homework/get.md): Retrieve a single homework class by its ID, with its assignment details and all student submissions. Returns 404 if the class is missing or has no homework.
- [POST /api/v3/admin/homeworks/grade/{id} — Grade Submission](https://developer.vclasses.net/docs/api-reference/homework/grade.md): Grade a student homework submission with a rating from 1 to 10 and an optional comment. Marks the submission as reviewed. Grades can be overwritten at any time.
- [GET /api/v3/admin/homeworks — List PDF Homework Classes](https://developer.vclasses.net/docs/api-reference/homework/list.md): Retrieve a paginated list of classes with PDF homework assignments, including all student submissions. Supports filtering by course ID and pagination controls.
- [VClasses REST API — Overview, Base URL, and Conventions](https://developer.vclasses.net/docs/api-reference/overview.md): The VClasses REST API base URL, versioning scheme, required request headers, and response format conventions every integration must follow.
- [GET /api/v3/quiz/pdf-quizzes/{id} — Get Quiz Details](https://developer.vclasses.net/docs/api-reference/quizzes/get.md): Retrieve a single PDF quiz by ID, including its question PDF metadata and the full list of student submission records. Requires an admin Bearer token.
- [Grade a PDF Quiz Submission — POST /api/v3/quiz/grade](https://developer.vclasses.net/docs/api-reference/quizzes/grade.md): Award a grade to a PDF quiz submission. Records the earned grade and total possible grade, marking the submission as graded. Requires admin Bearer token.
- [List All PDF Quizzes — GET /api/v3/quiz/pdf-quizzes](https://developer.vclasses.net/docs/api-reference/quizzes/list.md): Retrieve a paginated list of all PDF quizzes, including question PDF metadata and student submission records for each quiz. Requires an admin Bearer token.