root
91 lines
2.3 KiB
YAML
91 lines
2.3 KiB
YAML
openapi: 3.0.3
|
|
info: { title: Quiz API, version: 1.0.0 }
|
|
servers: [ { url: https://your-domain.com/api/v1 } ]
|
|
tags: [ { name: Quizzes } ]
|
|
security: [ { bearerAuth: [] } ]
|
|
|
|
paths:
|
|
/quizzes:
|
|
get:
|
|
tags: [Quizzes]
|
|
summary: List quizzes
|
|
parameters:
|
|
- in: query
|
|
name: page
|
|
schema: { type: integer, default: 1 }
|
|
- in: query
|
|
name: per_page
|
|
schema: { type: integer, default: 20 }
|
|
- in: query
|
|
name: student_id
|
|
schema: { type: integer }
|
|
- in: query
|
|
name: class_section_id
|
|
schema: { type: integer }
|
|
responses:
|
|
"200": { description: Quizzes retrieved }
|
|
post:
|
|
tags: [Quizzes]
|
|
summary: Create quiz row
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required: [student_id, class_section_id, quiz_index]
|
|
properties:
|
|
student_id: { type: integer }
|
|
class_section_id: { type: integer }
|
|
quiz_index: { type: integer }
|
|
score: { type: number }
|
|
comment: { type: string }
|
|
responses:
|
|
"201": { description: Quiz created }
|
|
|
|
/quizzes/{id}:
|
|
get:
|
|
tags: [Quizzes]
|
|
summary: Get quiz by ID
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
schema: { type: integer }
|
|
responses:
|
|
"200": { description: Quiz }
|
|
"404": { description: Not found }
|
|
put:
|
|
tags: [Quizzes]
|
|
summary: Update quiz row
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
schema: { type: integer }
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
score: { type: number }
|
|
comment: { type: string }
|
|
quiz_index: { type: integer }
|
|
responses:
|
|
"200": { description: Quiz updated }
|
|
|
|
/quizzes/student/{id}:
|
|
get:
|
|
tags: [Quizzes]
|
|
summary: Get quizzes by student
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
schema: { type: integer }
|
|
responses:
|
|
"200": { description: Student quizzes list }
|
|
|