Al-Farabi Kazakh National University

Al-Farabi Kazakh National University Ora Staff Grader API

The ora_staff_grader API from Al-Farabi Kazakh National University — 15 operation(s) for ora_staff_grader.

Documentation GitHub OpenAPI

Business capability

Marking & Grading Operations BC-4740.30

Operations 21

GET /ora_staff_grader/assessments/feedback/from/ View for fetching assessment feedback for a submission #

GET /ora_staff_grader/assessments/feedback/to/ View for fetching assessment feedback for a submission #

GET /ora_staff_grader/assessments/feedback/{id}/ View for fetching assessment feedback for a submission #

GET /ora_staff_grader/initialize Ora staff grader initialize read #

GET /ora_staff_grader/mock/initialize Ora staff grader mock initialize read #

GET /ora_staff_grader/mock/submission Ora staff grader mock submission read #

GET /ora_staff_grader/mock/submission/grade Ora staff grader mock submission grade read #

POST /ora_staff_grader/mock/submission/grade Ora staff grader mock submission grade create #

POST /ora_staff_grader/mock/submission/lock Ora staff grader mock submission lock create #

DELETE /ora_staff_grader/mock/submission/lock Ora staff grader mock submission lock delete #

GET /ora_staff_grader/mock/submission/status Ora staff grader mock submission status read #

GET /ora_staff_grader/submission Ora staff grader submission read #

GET /ora_staff_grader/submission/batch/unlock Ora staff grader submission batch unlock read #

POST /ora_staff_grader/submission/batch/unlock Ora staff grader submission batch unlock create #

GET /ora_staff_grader/submission/files GET file metadata for a submission #

GET /ora_staff_grader/submission/grade Ora staff grader submission grade read #

POST /ora_staff_grader/submission/grade Ora staff grader submission grade create #

GET /ora_staff_grader/submission/lock Ora staff grader submission lock read #

POST /ora_staff_grader/submission/lock Ora staff grader submission lock create #

DELETE /ora_staff_grader/submission/lock Ora staff grader submission lock delete #

GET /ora_staff_grader/submission/status Ora staff grader submission status read #

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/al-farabi-kazakh-national-university/refs/heads/main/openapi/al-farabi-kazakh-national-university-ora-staff-grader-api-openapi.yml

Other Resources

🔗

Swagger

https://open.kaznu.kz/swagger.json

🔗

x-json-schema

https://raw.githubusercontent.com/api-evangelist/al-farabi-kazakh-national-university/refs/heads/main/json-schema/al-farabi-kazakh-national-university-course-schema.json

🔗

x-json-structure

https://raw.githubusercontent.com/api-evangelist/al-farabi-kazakh-national-university/refs/heads/main/json-structure/al-farabi-kazakh-national-university-course-structure.json

🔗

x-examples

https://raw.githubusercontent.com/api-evangelist/al-farabi-kazakh-national-university/refs/heads/main/examples/al-farabi-kazakh-national-university-list-courses-example.json

🔗

x-spectral-rules

https://raw.githubusercontent.com/api-evangelist/al-farabi-kazakh-national-university/refs/heads/main/rules/al-farabi-kazakh-national-university-rules.yml

🔗

x-vocabulary

https://raw.githubusercontent.com/api-evangelist/al-farabi-kazakh-national-university/refs/heads/main/vocabulary/al-farabi-kazakh-national-university-vocabulary.yml

🔗

x-json-ld

https://raw.githubusercontent.com/api-evangelist/al-farabi-kazakh-national-university/refs/heads/main/json-ld/al-farabi-kazakh-national-university-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/al-farabi-kazakh-national-university:al-farabi-kazakh-national-university-ora-staff-grader-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Open edX Ora Staff Grader API
  description: APIs for access to Open edX information
  contact:
    email: dl@kaznu.kz
  version: v1
servers:
- url: https://open.kaznu.kz/api
security:
- Basic: []
tags:
- name: ora_staff_grader
paths:
  /ora_staff_grader/assessments/feedback/from/:
    get:
      operationId: ora_staff_grader_assessments_feedback_get_from
      summary: View for fetching assessment feedback for a submission
      description: '**Methods**


        * (GET) `api/ora_staff_grader/assessments/feedback/from`

        List all assessments received by a user (according to

        their submissionUUID) in an ORA assignment.


        * (GET) `api/ora_staff_grader/assessments/feedback/to`

        List all assessments given by a user (according to

        their submissionUUID) in an ORA assignment.


        **Query Params**:


        * `oraLocation` (str): ORA location for XBlock handling

        * `submissionUUID` (str): The ORA submission UUID


        **Response**:


        {

        assessments (List[dict]): [

        {

        "assessment_id: (str) Assessment id

        "scorer_name: (str) Scorer name

        "scorer_username: (str) Scorer username

        "scorer_email: (str) Scorer email

        "assessment_date: (str) Assessment date

        "assessment_scores (List[dict]) [

        {

        "criterion_name: (str) Criterion name

        "score_earned: (int) Score earned

        "score_type: (str) Score type

        }

        ]

        "problem_step (str) Problem step (Self, Peer, or Staff)

        "feedback: (str) Feedback of the assessment

        }

        ]

        }


        **Errors**:


        * `MissingParamResponse` (HTTP 400) for missing params

        * `BadOraLocationResponse` (HTTP 400) for bad ORA location

        * `XBlockInternalError` (HTTP 500) for an issue with ORA

        * `UnknownError` (HTTP 500) for other errors'
      tags:
      - ora_staff_grader
      parameters:
      - name: page
        in: query
        required: false
        description: A page number within the paginated result set.
        schema:
          type: integer
      - name: page_size
        in: query
        required: false
        description: Number of results to return per page.
        schema:
          type: integer
      responses:
        '200':
          description: ''
  /ora_staff_grader/assessments/feedback/to/:
    get:
      operationId: ora_staff_grader_assessments_feedback_get_to
      summary: View for fetching assessment feedback for a submission
      description: '**Methods**


        * (GET) `api/ora_staff_grader/assessments/feedback/from`

        List all assessments received by a user (according to

        their submissionUUID) in an ORA assignment.


        * (GET) `api/ora_staff_grader/assessments/feedback/to`

        List all assessments given by a user (according to

        their submissionUUID) in an ORA assignment.


        **Query Params**:


        * `oraLocation` (str): ORA location for XBlock handling

        * `submissionUUID` (str): The ORA submission UUID


        **Response**:


        {

        assessments (List[dict]): [

        {

        "assessment_id: (str) Assessment id

        "scorer_name: (str) Scorer name

        "scorer_username: (str) Scorer username

        "scorer_email: (str) Scorer email

        "assessment_date: (str) Assessment date

        "assessment_scores (List[dict]) [

        {

        "criterion_name: (str) Criterion name

        "score_earned: (int) Score earned

        "score_type: (str) Score type

        }

        ]

        "problem_step (str) Problem step (Self, Peer, or Staff)

        "feedback: (str) Feedback of the assessment

        }

        ]

        }


        **Errors**:


        * `MissingParamResponse` (HTTP 400) for missing params

        * `BadOraLocationResponse` (HTTP 400) for bad ORA location

        * `XBlockInternalError` (HTTP 500) for an issue with ORA

        * `UnknownError` (HTTP 500) for other errors'
      tags:
      - ora_staff_grader
      parameters:
      - name: page
        in: query
        required: false
        description: A page number within the paginated result set.
        schema:
          type: integer
      - name: page_size
        in: query
        required: false
        description: Number of results to return per page.
        schema:
          type: integer
      responses:
        '200':
          description: ''
  /ora_staff_grader/assessments/feedback/{id}/:
    get:
      operationId: ora_staff_grader_assessments_feedback_read
      summary: View for fetching assessment feedback for a submission
      description: '**Methods**


        * (GET) `api/ora_staff_grader/assessments/feedback/from`

        List all assessments received by a user (according to

        their submissionUUID) in an ORA assignment.


        * (GET) `api/ora_staff_grader/assessments/feedback/to`

        List all assessments given by a user (according to

        their submissionUUID) in an ORA assignment.


        **Query Params**:


        * `oraLocation` (str): ORA location for XBlock handling

        * `submissionUUID` (str): The ORA submission UUID


        **Response**:


        {

        assessments (List[dict]): [

        {

        "assessment_id: (str) Assessment id

        "scorer_name: (str) Scorer name

        "scorer_username: (str) Scorer username

        "scorer_email: (str) Scorer email

        "assessment_date: (str) Assessment date

        "assessment_scores (List[dict]) [

        {

        "criterion_name: (str) Criterion name

        "score_earned: (int) Score earned

        "score_type: (str) Score type

        }

        ]

        "problem_step (str) Problem step (Self, Peer, or Staff)

        "feedback: (str) Feedback of the assessment

        }

        ]

        }


        **Errors**:


        * `MissingParamResponse` (HTTP 400) for missing params

        * `BadOraLocationResponse` (HTTP 400) for bad ORA location

        * `XBlockInternalError` (HTTP 500) for an issue with ORA

        * `UnknownError` (HTTP 500) for other errors'
      tags:
      - ora_staff_grader
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
  /ora_staff_grader/initialize:
    get:
      operationId: ora_staff_grader_initialize_read
      description: GET course metadata
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader initialize read
      x-summary-source: derived
  /ora_staff_grader/mock/initialize:
    get:
      operationId: ora_staff_grader_mock_initialize_read
      description: Returns initial app state
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader mock initialize read
      x-summary-source: derived
  /ora_staff_grader/mock/submission:
    get:
      operationId: ora_staff_grader_mock_submission_read
      description: Get a submission
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader mock submission read
      x-summary-source: derived
  /ora_staff_grader/mock/submission/grade:
    get:
      operationId: ora_staff_grader_mock_submission_grade_read
      description: Submit a grade
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader mock submission grade read
      x-summary-source: derived
    post:
      operationId: ora_staff_grader_mock_submission_grade_create
      description: Save a grade update to the data store
      tags:
      - ora_staff_grader
      responses:
        '201':
          description: ''
      summary: Ora staff grader mock submission grade create
      x-summary-source: derived
  /ora_staff_grader/mock/submission/lock:
    post:
      operationId: ora_staff_grader_mock_submission_lock_create
      description: Claim a submission lock, updating lock status
      tags:
      - ora_staff_grader
      responses:
        '201':
          description: ''
      summary: Ora staff grader mock submission lock create
      x-summary-source: derived
    delete:
      operationId: ora_staff_grader_mock_submission_lock_delete
      description: Delete a submission lock, updating lock status
      tags:
      - ora_staff_grader
      responses:
        '204':
          description: ''
      summary: Ora staff grader mock submission lock delete
      x-summary-source: derived
  /ora_staff_grader/mock/submission/status:
    get:
      operationId: ora_staff_grader_mock_submission_status_read
      description: Get a submission status, leaving out the response
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader mock submission status read
      x-summary-source: derived
  /ora_staff_grader/submission:
    get:
      operationId: ora_staff_grader_submission_read
      description: GET submission contents and assessment info, if any
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader submission read
      x-summary-source: derived
  /ora_staff_grader/submission/batch/unlock:
    get:
      operationId: ora_staff_grader_submission_batch_unlock_read
      description: POST delete a group of submission locks, limited to just those in the list that the user owns.
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader submission batch unlock read
      x-summary-source: derived
    post:
      operationId: ora_staff_grader_submission_batch_unlock_create
      description: Batch delete submission locks
      tags:
      - ora_staff_grader
      responses:
        '201':
          description: ''
      summary: Ora staff grader submission batch unlock create
      x-summary-source: derived
  /ora_staff_grader/submission/files:
    get:
      operationId: ora_staff_grader_submission_files_read
      summary: GET file metadata for a submission
      description: 'Used to get updated file download links to avoid signed download link expiration

        issues.'
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
  /ora_staff_grader/submission/grade:
    get:
      operationId: ora_staff_grader_submission_grade_read
      description: POST submit a grade for a submission
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader submission grade read
      x-summary-source: derived
    post:
      operationId: ora_staff_grader_submission_grade_create
      description: Update a grade
      tags:
      - ora_staff_grader
      responses:
        '201':
          description: ''
      summary: Ora staff grader submission grade create
      x-summary-source: derived
  /ora_staff_grader/submission/lock:
    get:
      operationId: ora_staff_grader_submission_lock_read
      description: 'POST claim a submission lock for grading

        DELETE release a submission lock'
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader submission lock read
      x-summary-source: derived
    post:
      operationId: ora_staff_grader_submission_lock_create
      description: Claim a submission lock
      tags:
      - ora_staff_grader
      responses:
        '201':
          description: ''
      summary: Ora staff grader submission lock create
      x-summary-source: derived
    delete:
      operationId: ora_staff_grader_submission_lock_delete
      description: Clear a submission lock
      tags:
      - ora_staff_grader
      responses:
        '204':
          description: ''
      summary: Ora staff grader submission lock delete
      x-summary-source: derived
  /ora_staff_grader/submission/status:
    get:
      operationId: ora_staff_grader_submission_status_read
      description: GET submission grade status, lock status, and grade data
      tags:
      - ora_staff_grader
      responses:
        '200':
          description: ''
      summary: Ora staff grader submission status read
      x-summary-source: derived
components:
  securitySchemes:
    Basic:
      type: http
      scheme: basic