Feedbacks

POST - Feedback Query

This endpoint allows a student, teacher, or parent to reply to a query that has been raised against a specific feedback query. Additionally, a student can reply to the AI response related to the feedback query. You need to provide the exam ID, answer sheet ID, answer ID, feedback ID, and feedback query ID to identify the query.

Scenario: Student Replying to a Feedback Query:

Student’s Additional Clarification:
- After receiving AI-generated feedback and the AI’s response to their query, a student may want to explain why they believe their answer should be graded differently or address any misunderstandings.
- Outcome:
  - The student’s reply is stored and linked to the specific feedback query, offering further context for the evaluator to review.

Scenario: Teacher or Parent Replying to a Query:

Teacher or Parent’s Input:
- A teacher or parent might reply to a query raised by the student to clarify feedback, explain reasoning behind marks, or provide additional insights.
- Outcome:
  - The teacher or parent’s reply is stored, ensuring more transparency in the evaluation process.

POST

evaluation-platform

exam

{examId}

answer-sheet

{ansSheetId}

answer

{ansId}

feedback

{feedbackId}

query

{feedbackQueryId}

curl --request POST \
  --url https://api-staging.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/ \
  --header 'Content-Type: application/json' \
  --data '{
  "text": "ok got it"
}'

{
  "data": {
    "id": "def80534-8f59-49ea-b43e-553075b1db91",
    "examId": "edaf2e84-e911-4150-9628-6d182a05ed0d",
    "studentId": "10160091",
    "answerId": "11637fca-dc77-4b63-88c0-ec74126d951c",
    "feedback": "The student selected an incorrect option. It is important to carefully analyze the question and the options provided. Understanding the characteristics of a homologous series is crucial for answering such questions correctly.",
    "marks_deducted": "1 - incorrect option selected",
    "justification": "The student's answer (c) gradation in Physical Properties is incorrect as it does not address the question of what is not observed in a homologous series. The model answer correctly identifies (a) Change in chemical properties as the correct response.",
    "room_for_improvement": "To achieve full marks, the student should select the correct option (a) Change in chemical properties, which is the only option that is not observed in a homologous series.",
    "feedbackQuery": [
      {
        "id": "e2b75a94-bc8a-4a2b-a23f-32abc1198f37",
        "createdByRole": "Student",
        "queryType": 1,
        "status": 3,
        "text": "why my marks has been deducted",
        "responses": [
          {
            "id": "3421ecec-30fd-4a51-89ba-aa796332ba51",
            "createdByRole": "AI",
            "text": "The student's selected answer '(c) gradation in Physical Properties' is incorrect according to the marking scheme. The correct answer is '(a) Change in chemical properties', as homologous series have the same functional group and show a gradation in physical properties, but do not have a change in chemical properties. Therefore, no change in marks is warranted."
          }
        ]
      }
    ]
  }
}

Path Parameters

examId

string

required

Unique identifier of the exam.

ansSheetId

string

required

Unique identifier of the answer sheet.

ansId

string

required

Unique identifier of the answer.

feedbackId

string

required

Unique identifier of the feedback.

feedbackQueryId

string

required

Unique identifier of the feedback query.

Body

application/json

text

string

Text of the feedback query.

Example:

"ok got it"

Response

200 - application/json

Success - Feedback details retrieved successfully.

data

object

data.id

string

Feedback unique identifier against the answers.

Example:

"def80534-8f59-49ea-b43e-553075b1db91"

data.examId

string

Unique identifier of the exam.

Example:

"edaf2e84-e911-4150-9628-6d182a05ed0d"

data.studentId

string

Unique identifier of the student.

Example:

"10160091"

data.answerId

string

Unique identifier of the answer.

Example:

"11637fca-dc77-4b63-88c0-ec74126d951c"

data.feedback

string

Feedback provided for the answer.

Example:

"The student selected an incorrect option. It is important to carefully analyze the question and the options provided. Understanding the characteristics of a homologous series is crucial for answering such questions correctly."

data.marks_deducted

string

Marks deducted for the answer.

Example:

"1 - incorrect option selected"

data.justification

string

Justification for the feedback provided.

Example:

"The student's answer (c) gradation in Physical Properties is incorrect as it does not address the question of what is not observed in a homologous series. The model answer correctly identifies (a) Change in chemical properties as the correct response."

data.room_for_improvement

string

Room for improvement for the student.

Example:

"To achieve full marks, the student should select the correct option (a) Change in chemical properties, which is the only option that is not observed in a homologous series."

data.feedbackQuery

object[]

Feedback query raise by the student

PATCH - Raise Feedback GET - Constants

curl --request POST \
  --url https://api-staging.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/ \
  --header 'Content-Type: application/json' \
  --data '{
  "text": "ok got it"
}'

{
  "data": {
    "id": "def80534-8f59-49ea-b43e-553075b1db91",
    "examId": "edaf2e84-e911-4150-9628-6d182a05ed0d",
    "studentId": "10160091",
    "answerId": "11637fca-dc77-4b63-88c0-ec74126d951c",
    "feedback": "The student selected an incorrect option. It is important to carefully analyze the question and the options provided. Understanding the characteristics of a homologous series is crucial for answering such questions correctly.",
    "marks_deducted": "1 - incorrect option selected",
    "justification": "The student's answer (c) gradation in Physical Properties is incorrect as it does not address the question of what is not observed in a homologous series. The model answer correctly identifies (a) Change in chemical properties as the correct response.",
    "room_for_improvement": "To achieve full marks, the student should select the correct option (a) Change in chemical properties, which is the only option that is not observed in a homologous series.",
    "feedbackQuery": [
      {
        "id": "e2b75a94-bc8a-4a2b-a23f-32abc1198f37",
        "createdByRole": "Student",
        "queryType": 1,
        "status": 3,
        "text": "why my marks has been deducted",
        "responses": [
          {
            "id": "3421ecec-30fd-4a51-89ba-aa796332ba51",
            "createdByRole": "AI",
            "text": "The student's selected answer '(c) gradation in Physical Properties' is incorrect according to the marking scheme. The correct answer is '(a) Change in chemical properties', as homologous series have the same functional group and show a gradation in physical properties, but do not have a change in chemical properties. Therefore, no change in marks is warranted."
          }
        ]
      }
    ]
  }
}

Authentication

K12

Assessment Rubrics

Standardized Language Exams

POST - Feedback Query

Path Parameters

Body

Response