Page Comparison

...

objectType	metadata	Current Data Type (v1 api)	Expected Data Type (v2 api)
QuestionSet	instructions	object	object
QuestionSet	feedback	object	object
Question	body	string	object
Question	instructionsanswer	objectstring	object
Question	answerinstructions	stringobject	object
Question	hints	array of string	object
Question	feedback	object	object
Question	solutions	array of object	object
Question	interactions	object	object

...

inQuiry will provide Question & QuestionSet V2 api’s which will provide CRUD operation for multilingual data.

api versionPublicly Exposed API	Service Level API’s	qumlVersion	schemaVersion	version	compatibilityLevel
v1 v1 api’s	v4 api’s	supports 1.0 but not stamped in the data as of now.	1.0	1	5
v2 api’s	v5 api’s	supports 1.021 onwards. 0	2	6

version or schemaVersion metadata will be set as 2 by default from micro-service for v2 api’s.
Current compatibilityLevel is set to 5 for the data created using v1 api’s. For v2 api’s, it will be set to 6 so that users should be able to discover and play only on latest app having latest player.
async-questionset-publish flink job will handle different data validation based on schemaVersion / version.
schemaVersion will be used inside player, based on schemaVersion, player will switch the logic to process data.
player won't understand comaptibilityLevel, but will upgrade it to 6 for backward compatibility (existing apps).
data versioning will be implemented to store multiple version data at platform.
if quml specification will get updated in future,
- if it is a minor change, the change can be accommodated in v2 api’s.
- if spec will have major breaking change, we need to write next version of api’s.
For existing data created using v1 api’s, we have two approach as mentioned below:
- No static Data Migration for existing objects and data transformation in question read & list api at run time to support v2 api spec.
- One time static Data Migration

No Static Migration:

Pros:

Old version of questionset-editor & mobile app works fine with v1 api.
Once older questions edited using v2 editor and api's, it will be migrated to v2 data model. So end user (consumption) won’t be affected on immediate basis and at that point old player will not be able to discover the question (comaptibilityLevel will be upgraded to maintain backward compatibility of Sunbird-Ed mobile app).

Cons:

Platform need to understand all multi-language data (including editorState) and transform it to v2 api format for every read & list api call.
API Performance will be affected (specially question list api). To improve performance, cache will be implemented for list api to hold data post data transformation (currently no cache implementation present for list api).
Once the data is migrated to v2 data model, old player will not be able to discover the question (comaptibilityLevel will be upgraded).

Static Migration:

Pros:

Consumption api’s (question read & list api) doesn't need any run-time data transformation. So api performance won’t be affected.

Cons:

old mobile app won't be able to render existing questions for online consumption.
old editor also start breaking even for v1 api’s

API Specification:

Question Create API:

request_1:

...

language	json

...

inquiry v2 api’s will support multiple QuML version.
- It support QuML version 1.1 onwards.
- For each version of QuML, inquiry will maintain different schema folder.
- User can send the qumlVersion metadata in create request payload. if it is valid, payload will be validated against respective schema.
- If user doesn’t provide qumlVersion, micro-service will use default qumlVersion configured in micro-service through a service level configuration.
- micro-service will also maintain a configuration for all supported QuML version. e.g: api_v5_supported_quml_version=[1.1, 1.2, 1.3]
- inquiry will stamp qumlVersion to all objects created through v2 api’s and same will be used during read and update api’s calls.
- once question or questionset created against a specific QuML version, qumlVersion can’t be upgraded/downgraded through update api’s. It is restricted to avoid any data corruption.
- addition of new quml version require few code changes like adding schema and application configurations, code changes to flink job.
Current compatibilityLevel is set to 5 for the data created using v1 api’s. For v2 api’s, it will be set to 6 so that users should be able to discover and play only on latest app having latest player.
- Going forward, adopters should use qumlVersion metadata to control discovery of question/questionset.
- QuML player won't understand comaptibilityLevel, but will upgrade it to 6 for backward compatibility (existing apps).
qumlVersion should be used by QuML player.
- QuML payer should use the metadata for checking player compatibility. This will remove dependency of metadata compatibilityLevel at application layer.
- based on qumlVersion, player should switch the logic to process data.
data filter based on language capability will be enabled for question read and list api’s. query parameter lang=language_code will be used. e.g: ?lang=en
As of now, inquiry v2 api’s will not follow spec for below properties
- properties: interactions & visibility
- interactions: will be implemented, once format is generalised for all question types at spec level.
- visibility: inquiry will continue to use default visibility which is used as public visibility across all components including other building blocks.
async-questionset-publish flink job will handle different data validation based on qumlVersion.
v2 review & publish api won’t allow data having qumlVersion less than 1.1
- existing data having qumlVersion 1.0 must be migrated before sending to review & publish v2 api’s.
- inquiry will provide auto-migration to qumlVersion 1.1 using v2 update api.
question & questionset v1 api’s will be enhanced to throw an error, when user try to read/update data created using v2 api’s. qumlVersion check will be enabled for v1 api’s as well to achieve the behaviour.
For existing data created using v1 api’s, we have two approach as mentioned below:
- No static Data Migration for existing objects and data transformation in question read & list api at run time to support v2 api spec.
- One time static Data Migration

No Static Migration:

Pros:

Old version of questionset-editor & mobile app works fine with v1 api.
Once older questions edited using v2 editor and api's, it will be migrated to v2 data model. So end user (consumption) won’t be affected on immediate basis and at that point old mobile app will not be able to discover the question (comaptibilityLevel will be upgraded to maintain backward compatibility of Sunbird-Ed mobile app).

Cons:

Platform need to understand all multi-language data (including editorState) and transform it to v2 api format for every read & list api call.
API Performance will be affected (specially question list api). To improve performance, cache will be implemented for list api to hold data post data transformation (currently no cache implementation present for list api).
Once the data is migrated to v2 data model, old player will not be able to discover the question (comaptibilityLevel will be upgraded).

Static Migration:

Pros:

Consumption api’s (question read & list api) doesn't need any run-time data transformation. So api performance won’t be affected.

Cons:

old mobile app won't be able to render existing questions for online consumption.
old editor also start breaking even for v1 api’s

API Specification:

Question Create API:

Sample Input for single language:

Code Block

language	json

{
  "name": "Name of the question",
  "code": "unique code of the question",
  "mimeType": "application/vnd.sunbird.question",
  "primaryCategory": "Multiple Choice Question",
  "interactionTypes": ["choice"],
  "qumlVersion": 1.1,
  "media": [
    {
      "id": "do_2137498365362995201237",
      "type": "image",
      "src": "/assets/public/content/assets/do_2137498365362995201237/tea.jpeg",
      "baseUrl": "https://dev.inquiry.sunbird.org"
    }
  ],
  "body": "<div class='question-body' tabindex='-1'><div class='mcq-title' tabindex='0'><p><span style=\"background-color:#ffffff;color:#202124;\">Which of the following crops is a commercial crop?</span></p></div><div data-choice-interaction='response1' class='mcq-vertical'></div></div>",
  "answer": "<p>Barley</p>",
  "instructions": {
    "language_code": "<div>...</div>"
  },
  "hints": {
    "hint_1": "<div>...</div>",
    "hint_2": "<div>...</div>"
  },
  "feedback": {
    "feedback_1": "<div>...</div>",
    "feedback_2": "<div>...</div>"
  },
  "solutions": {
    "solution_1": "solution 1 html string",
    "solution_2": "solution 2 html string"
  },
  "interactions": {
    "response1": {
      "type": "choice",
      "options": [
        {
          "label": "<p>Wheat</p>",
          "value": "w"
        },
        {
          "label": "<p>Barley</p>",
          "value": "b"
        },
        {
          "label": "<p>Maize</p>",
          "value": "m"
        },
        {
          "label": "<p>Tea</p>",
          "value": "t"
        }
      ],
      "validation": {
        "required": "Yes"
      }
    }
  },
  "responseDeclaration": {
    "response1": {
      "cardinality": "single",
      "type": "integer",
      "correctResponse": {
        "value": 3
      },
      "mapping": [
        {
          "value": 2,
          "score": 0.5
        },
        {
          "value": 1,
          "score": 0.25
        }
      ]
    }
  },
  "outcomeDeclaration": {
    "maxScore": {
      "cardinality": "single",
      "type": "integer",
      "defaultValue": 3
    }
  },
  // any additional properties goes here. e.g: framework, createdBy, etc..
}

In the above request spec, a default language code (configured in the system at object level schema) will be injected and data will be transformed (as mentioned in multi language format ) to v2 format and then saved to database.
The data transformation will be done to support both formats mentioned in quml specification.

Sample Input for multi-language (default input):

Code Block

language	json

{
  "name": "Name of the question",
  "code": "unique code of the question",
  "mimeType": "application/vnd.sunbird.question",
  "primaryCategory": "Multiple Choice Question",
  "interactionTypes": ["choice"],
  "qumlVersion": 1.1,
  "media": [
    {
      "id": "do_2137498365362995201237",
      "type": "image",
      "src": "/assets/public/content/assets/do_2137498365362995201237/tea.jpeg",
      "baseUrl": "https://dev.inquiry.sunbird.org"
    }
  ],
  "body": {
    "language_code": "<div class='question-body' tabindex='-1'><div class='mcq-title' tabindex='0'><p><span style=\"background-color:#ffffff;color:#202124;\">Which of the following crops is a commercial crop?</span></p></div><div data-choice-interaction='response1' class='mcq-vertical'></div></div>"
  },
  "answer": {
    "language_code": "<p>Barley</p>"
  },
  "instructions": {
    "language_code": "<div>...</div>"
  },
  "hints": {
    "hint_1": {
      "language_code": "<div>...</div>"
    },
    "hint_2": {
      "language_code": "<div>...</div>"
    }
  },
  "feedback": {
    "feedback_1": {
      "language_code": "<div>...</div>"
    },
    "feedback_2": {
      "language_code": "<div>...</div>"
    }
  },
  "solutions": {
    "solution_1": {
      "language_code": "<div>...</div>"
    },
    "solution_2": {
      "language_code": "<div>...</div>"
    }
  },
  "interactions": {
    "response1": {
      "type": "choice",
      "options": [
        {
          "label": {
            "language_code": "<p>Wheat</p>"
          },
          "value": 1
        },
        {
          "label": {
            "language_code": "<p>Barley</p>"
          },
          "value": 2
        },
        {
          "label": {
            "language_code": "<p>Maize</p>"
          },
          "value": 3
        },
        {
          "label": {
            "language_code": "<p>Tea</p>"
          },
          "value": 4
        }
      ],
      "validation": {
        "required": "Yes"
      }
    }
  },
  "responseDeclaration": {
    "response1": {
      "cardinality": "single",
      "type": "integer",
      "correctResponse": {
        "value": 3
      },
      "mapping": [
        {
          "value": 2,
          "score": 0.5
        },
        {
          "value": 1,
          "score": 0.25
        }
      ]
    }
  },
  "outcomeDeclaration": {
    "maxScore": {
      "cardinality": "single",
      "type": "integer",
      "defaultValue": 3
    }
  },
  // any additional properties goes here. e.g: framework, createdBy, etc..
}

Success Response (200):

Code Block

language	json

{
    "id": "api.question.create",
    "ver": "5.0",
    "ts": "2023-01-30T19:43:43ZZ",
    "params": {
        "resmsgid": "ca1ed6b6-994d-487c-8ecd-0ca164a84c94",
        "msgid": null,
        "err": null,
        "status": "successful",
        "errmsg": null
    },
    "responseCode": "OK",
    "result": {
        "identifier": "do_2137224832856555521270",
        "versionKey": "1675107822985"
    }
}

Question Read API:

Request:

Code Block
curl --location --request GET 'https://dev.inquiry.sunbird.org/api/question/v2/read/do_213688205764337664161?mode=edit&fields=answer,instructions' \ --header 'Authorization: {{api_key_new}}'

Response:

question read api will always return will data in below format:

Code Block

language	json

{
  "id": "api.question.read",
  "ver": "5.0",
  "ts": "2023-01-30T03:28:23ZZ",
  "params": {
    "resmsgid": "db23eb9e-207c-488c-a45a-7da36a2084ee",
    "msgid": null,
    "err": null,
    "status": "successful",
    "errmsg": null
  },
  "responseCode": "OK",
  "result": {
    "question": {
      "identifier": "do_213688205764337664161",
      "qumlVersion": 1.1,
      "media": [
        {
          "id": "do_2137498365362995201237",
          "type": "image",
          "src": "/assets/public/content/assets/do_2137498365362995201237/tea.jpeg",
          "baseUrl": "https://dev.inquiry.sunbird.org"
        }
      ],
      "body": {
        "language_code": "<div class='question-body' tabindex='-1'><div class='mcq-title' tabindex='0'><p><span style=\"background-color:#ffffff;color:#202124;\">Which of the following crops is a commercial crop?</span></p></div><div data-choice-interaction='response1' class='mcq-vertical'></div></div>"
      },
      "answer": {
        "language_code": "<p>Barley</p>"
      },
      "instructions": {
        "language_code": "<div>...</div>"
      },
      "hints": {
        "hint_1": {
          "language_code": "<div>...</div>"
        },
        "hint_2": {
          "language_code": "<div>...</div>"
        }
      },
      "feedback": {
        "feedback_1": {
          "language_code": "<div>...</div>"
        },
        "feedback_2": {
          "language_code": "<div>...</div>"
        }
      },
      "solutions": {
        "solution_1": {
          "language_code": "<div>...</div>"
        },
        "solution_2": {
          "language_code": "<div>...</div>"
        }
      },
      "interactions": {
        "response1": {
          "type": "choice",
          "options": [
            {
              "label": {
                "language_code": "<p>Wheat</p>"
              },
              "value": 1
            },
            {
              "label": {
                "language_code": "<p>Barley</p>"
              },
              "value": 2
            },
            {
              "label": {
                "language_code": "<p>Maize</p>"
              },
              "value": 3
            },
            {
              "label": {
                "language_code": "<p>Tea</p>"
              },
              "value": 4
            }
          ],
          "validation": {
            "required": "Yes"
          }
        }
      },
      "responseDeclaration": {
        "response1": {
          "cardinality": "single",
          "type": "integer",
          "correctResponse": {
            "value": 3
          },
          "mapping": [
            {
              "value": 2,
              "score": 0.5
            },
            {
              "value": 1,
              "score": 0.25
            }
          ]
        }
      },
      "outcomeDeclaration": {
        "maxScore": {
          "cardinality": "single",
          "type": "integer",
          "defaultValue": 3
        }
      }
    }
  }
}

the read api transforms data created using v1 api’s. It injects default language code configured in the system at object level schema and return the response to user.
same transformation will be applicable in Question List API
if specific language data is demanded using query param lange=language_code then only that language data will be returned.
- if the requested language data is not available, api will return system default language data.
- what should be behaviour????

Question Update API:

Question Update API also support both spec as mentioned in create api.
For older data (created with v1 api’s), on v2 api update call, data will be migrated to v2 api format as well as qumlVersion will be set to 1.1.

Sample Input for Update API (single language):

Code Block

language	json

{
  "name": "Name of the question",
  "versionKey": "123456"
  "media": [
    {
      "id": "do_2137498365362995201237",
      "type": "image",
      "src": "/assets/public/content/assets/do_2137498365362995201237/tea.jpeg",
      "baseUrl": "https://dev.inquiry.sunbird.org"
    }
  ],
  "body": "<div class='question-body' tabindex='-1'><div class='mcq-title' tabindex='0'><p><span style=\"background-color:#ffffff;color:#202124;\">Which of the following crops is a commercial crop?</span></p></div><div data-choice-interaction='response1' class='mcq-vertical'></div></div>",
  "answer": "<p>Barley</p>",
  "instructions": {
    "language_code": "<div>...</div>"
  },
  "hints": {
    "hint_1": "<div>...</div>",
    "hint_2": "<div>...</div>"
  },
  "feedback": {
    "feedback_1": "<div>...</div>",
    "feedback_2": "<div>...</div>"
  },
  "solutions": {
    "solution_1": "solution 1 html string",
    "solution_2": "solution 2 html string"
  },
  "interactions": {
    "response1": {
      "type": "choice",
      "options": [
        {
          "label": "<p>Wheat</p>",
          "value": "w"
        },
        {
          "label": "<p>Barley</p>",
          "value": "b"
        },
        {
          "label": "<p>Maize</p>",
          "value": "m"
        },
        {
          "label": "<p>Tea</p>",
          "value": "t"
        }
      ],
      "validation": {
        "required": "Yes"
      }
    }
  },
  "responseDeclaration": {
    "response1": {
      "cardinality": "single",
      "type": "integer",
      "correctResponse": {
        "value": 3
      },
      "mapping": [
        {
          "value": 2,
          "score": 0.5
        },
        {
          "value": 1,
          "score": 0.25
        }
      ]
    }
  },
  "outcomeDeclaration": {
    "maxScore": {
      "cardinality": "single",
      "type": "integer",
      "defaultValue": 3
    }
  }
}

Sample Input for Update API (default input format):

Code Block

language	json

{
  "versionKey": "12345"
  "name": "Name of the question",
  "media": [
    {
      "id": "do_2137498365362995201237",
      "type": "image",
      "src": "/assets/public/content/assets/do_2137498365362995201237/tea.jpeg",
      "baseUrl": "https://dev.inquiry.sunbird.org"
    }
  ],
  "body": {
    "language_code": "<div class='question-body' tabindex='-1'><div class='mcq-title' tabindex='0'><p><span style=\"background-color:#ffffff;color:#202124;\">Which of the following crops is a commercial crop?</span></p></div><div data-choice-interaction='response1' class='mcq-vertical'></div></div>"
  },
  "answer": {
    "language_code": "<p>Barley</p>"
  },
  "instructions": {
    "language_code": "<div>...</div>"
  },
  "hints": {
    "hint_1": {
      "language_code": "<div>...</div>"
    },
    "hint_2": {
      "language_code": "<div>...</div>"
    }
  },
  "feedback": {
    "feedback_1": {
      "language_code": "<div>...</div>"
    },
    "feedback_2": {
      "language_code": "<div>...</div>"
    }
  },
  "solutions": {
    "solution_1": {
      "language_code": "<div>...</div>"
    },
    "solution_2": {
      "language_code": "<div>...</div>"
    }
  },
  "interactions": {
    "response1": {
      "type": "choice",
      "options": [
        {
          "label": {
            "language_code": "<p>Wheat</p>"
          },
          "value": 1
        },
        {
          "label": {
            "language_code": "<p>Barley</p>"
          },
          "value": 2
        },
        {
          "label": {
            "language_code": "<p>Maize</p>"
          },
          "value": 3
        },
        {
          "label": {
            "language_code": "<p>Tea</p>"
          },
          "value": 4
        }
      ],
      "validation": {
        "required": "Yes"
      }
    }
  },
  "responseDeclaration": {
    "response1": {
      "cardinality": "single",
      "type": "integer",
      "correctResponse": {
        "value": 3
      },
      "mapping": [
        {
          "value": 2,
          "score": 0.5
        },
        {
          "value": 1,
          "score": 0.25
        }
      ]
    }
  },
  "outcomeDeclaration": {
    "maxScore": {
      "cardinality": "single",
      "type": "integer",
      "defaultValue": 3
    }
  }
}

Response:

Code Block

language	json

{
    "id": "api.question.update",
    "ver": "5.0",
    "ts": "2023-01-30T19:43:43ZZ",
    "params": {
        "resmsgid": "ca1ed6b6-994d-487c-8ecd-0ca164a84c94",
        "msgid": null,
        "err": null,
        "status": "successful",
        "errmsg": null
    },
    "responseCode": "OK",
    "result": {
        "identifier": "do_2137224832856555521270",
        "versionKey": "1675107822985"
    }
}

Question Review API :

there is no change in spec from v1 to v2 api.
For older data, the api will throw client error if the qumlVersion is 1.0.

Question Publish API:

there is no change in spec from v1 to v2 api.
For older data, the api will throw client error if the qumlVersion is 1.0.

Question Retire API:

there is no change in spec from v1 to v2 api.
there is no change for logical behaviour of the api

Question Copy API:

there is no change in spec from v1 to v2 api.
the api will support copy operation only if object qumlVersion match with default qumlVersion supported by the micro-service.
For older data, the api will throw client error if the qumlVersion is 1.0. First the data should be migrated.

QuestionSet API’s:

QuestionSet Create API:

there is no change in spec from v1 to v2 api.
for instructions metadata, editor need to send specific language code in the data.
- if language code is not supplied, default language code will be injected at platform level.

QuestionSet Read API & Hierarchy Read API:

For older data, language code will be stamped and data transformation will be done before returning the response for below fields:

instructions, hints & feedback
data sample:

Code Block

"instructions": {
    "language_code": "<div>...</div>"
  },
  "hints": {
    "hint_1": {
      "language_code": "<div>...</div>"
    },
    "hint_2": {
      "language_code": "<div>...</div>"
    }
  },
  "feedback": {
    "feedback_1": {
      "language_code": "<div>...</div>"
    },
    "feedback_2": {
      "language_code": "<div>...</div>"
    }
  }

QuestionSet Update Hierarchy API:
Sample Input Request with single language attributes:

Code Block

language	json

{
  "request": {
    "data": {
      "nodesModified": {
        "q1": {
          "metadata": {
            "name": "Name of the question",
            "code": "q1",
            "mimeType": "application/vnd.sunbird.question",
            "primaryCategory": "Multiple Choice Question",
            "interactionTypes": [
              "choice"
            ],
            "qumlVersion": 1.1,
            "media": [
              {
                "id": "do_2137498365362995201237",
                "type": "image",
                "src": "/assets/public/content/assets/do_2137498365362995201237/tea.jpeg",
                "baseUrl": "https://dev.inquiry.sunbird.org"
              }
            ],
            "body": "<div class='question-body' tabindex='-1'><div class='mcq-title' tabindex='0'><p><span style=\"background-color:#ffffff;color:#202124;\">Which of the following crops is a commercial crop?</span></p></div><div data-choice-interaction='response1' class='mcq-vertical'></div></div>",
            "answer": "<p>Barley</p>",
            "instructions": {
        "feedback_id_1": "feedback-1",
        "feedbacklanguage_id_2code": "feedback-2<div>...</div>"
      },       "solutions": [},
         {        "hints": {
  "id": "bc6e4294-1a19-4e75-fb43-871f0e54b0e8",           "typehint_1": "html<div>...</div>",
           "value   "hint_2": "solution in HTML format"<div>...</div>"
            },
        {    "feedback": {
     "id": "bc6e4294-1a19-4e75-fb43-871f0e54b0e9",           "typefeedback_1": "html<div>...</div>",
              "valuefeedback_2": "a question can have more than one solution. in such cases, another solution in HTML format"<div>...</div>"
            }
,
     ],       "interactionssolutions": {
        "response1": {     "solution_1": "solution 1 html string",
  "type": "choice",           "optionssolution_2": "solution [2 html string"
          {  },
            "labelinteractions": "<p>Floral organs</p>",{
               "valueresponse1": 0{
            },           "type": "choice",
 {               "labeloptions": "<p>Veins[
 and veinlets in a lamina</p>",             {
 "value": 1             }       "label": "<p>Wheat</p>",
   ]         },         "validationvalue": {"w"
          "required": "Yes"       },
 }       }     }   }
}

In the above request spec, a default language code (configured in the system at object level schema) will be injected and data will be transformed (as mentioned in request_2 ) to v2 format and then saved to database.
The data transformation will be done to support both formats mentioned in quml specification.

request_2:

Code Block

language	json

{
  "request": {  {
            "question": {       "namelabel": "question_title<p>Barley</p>",
      "code              "value": "{{$randomUUID}}","b"
                  },
                  {
           "mimeType": "application/vnd.sunbird.question",         "primaryCategorylabel": "Multiple Choice Question","<p>Maize</p>",
          "body": {         "language_code_1value": "m"question
 body as string in specified language."       },     },
 "instructions": {         "language_code": "instructions in HTML format."   {
   },       "answer": {         "language_codelabel": "<p>Tea</p>"answer,
in specified language"       },       "hints": {   "value": "t"
    "language_code": [             "hint-1",   }
       "hint-2"         ],
       },         "feedbackvalidation": {
        "feedback_id_1": {           "language_coderequired": "feedback-1Yes"
         },       }
     "feedback_id_2": {        }
  "language_code": "feedback-2"         },
      },       "solutionsresponseDeclaration": {
              "language_coderesponse1": [ {
                "cardinality": "single",
    {             "idtype": "bc6e4294-1a19-4e75-fb43-871f0e54b0e8integer",
                "typecorrectResponse": "html", {
              "value": "solution in HTML format"value": 3
         },       },
   {             "idmapping": "bc6e4294-1a19-4e75-fb43-871f0e54b0e9",[
               "type": "html",  {
          "value": "a question can have more than one solution. in such cases"value": 2,
another  solution in HTML format"           }    "score": 0.5
   ]       },       "interactions": { },
        "response1": {         {
 "type": "choice",           "options": [      "value": 1,
     {               "labelscore": {0.25
                 "language_code": "<p>Floral organs</p>" }
               }, ]
             "value": 0}
            },
            "outcomeDeclaration": {
              "labelmaxScore": {
                "language_codecardinality": "<p>Veinssingle",
and veinlets in a lamina</p>"            "type": "integer",
 },               "valuedefaultValue": 13
            }  }
        ]    }
    },      },
  "validation": {           "requiredobjectType": "YesQuestion",
        }  "root": false,
   }
    }   } }

Response:

Code Block

language	json

{     "idisNew": "api.question.create",true
    "ver": "5.0",     "ts": "2023-01-30T19:43:43ZZ",}
    "params": {  },
      "resmsgidhierarchy": "ca1ed6b6-994d-487c-8ecd-0ca164a84c94",{
        "msgidquestionset_identifier": null,{
          "errchildren": null,[
            "statusq1":
 "successful",         "errmsg": null],
     },     "responseCoderoot": "OK",true
       "result": {}
      }
 "identifier": "do_2137224832856555521270",  }
  }
}
  "versionKey": "1675107822985"

Sample Input Request with multi-language attributes (default format):

Code Block

language	json

{
  "request": {
   }
}

Question Read API:

Request:

Code Block
curl --location --request GET 'https://dev.inquiry.sunbird.org/api/question/v2/read/do_213688205764337664161?mode=edit&fields=answer,instructions' \ --header 'Authorization: {{api_key_new}}'

Response:

question read api will always return will data in below format:

Code Block

language	json

{
  "id": "api.question.read",
  "ver": "5.0",
  "ts": "2023-01-30T03:28:23ZZ",
  "params": { "data": {
      "nodesModified": {
        "q1": {
          "metadata": {
            "name": "Name of the question",
            "code": "q1",
            "resmsgidmimeType": "db23eb9e-207c-488c-a45a-7da36a2084ee",application/vnd.sunbird.question",
            "msgidprimaryCategory": null"Multiple Choice Question",
    "err": null,        "statusinteractionTypes": "successful", [
       "errmsg": null   },   "responseCodechoice":
"OK",   "result": {     "question": {  ],
    "identifier": "do_213688205764337664161",       "bodyqumlVersion": { 1.1,
            "language_code_1media": [
 "question body as string in specified language."       },{
      "instructions": {         "language_codeid": "instructionsdo_2137498365362995201237",
in HTML format."       },       "answertype": {"image",
                "language_codesrc": "answer in specified language"/assets/public/content/assets/do_2137498365362995201237/tea.jpeg",
         },       "baseUrl"hints: "https: {//dev.inquiry.sunbird.org"
              }
"language_code": [           "hint-1",],
            "hint-2body": {
       ]       },
      "feedback": {
        "feedback_id_1": {"language_code": "<div class='question-body' tabindex='-1'><div class='mcq-title' tabindex='0'><p><span style=\"background-color:#ffffff;color:#202124;\">Which of the following crops is a commercial crop?</span></p></div><div data-choice-interaction='response1' class='mcq-vertical'></div></div>"
           "language_code": "feedback-1" },
        },    "answer": {
   "feedback_id_2": {           "language_code": "feedback-2"
  <p>Barley</p>"
     }       },
      "solutions": {
        "language_codeinstructions": [
        {
 {             "idlanguage_code": "bc6e4294-1a19-4e75-fb43-871f0e54b0e8",
     <div>...</div>"
      "type": "html",         },
   "value": "solution in HTML format"     "hints": {
    },          "hint_1": {
            "id    "language_code": "bc6e4294-1a19-4e75-fb43-871f0e54b0e9",<div>...</div>"
             "type": "html", },
              "valuehint_2": {
"a   question can have more than one solution. in such cases, another solution in HTML format" "language_code": "<div>...</div>"
           }   }
     ]       },
            "interactionsfeedback": {
        "response1": {     "feedback_1": {
    "type": "choice",           "optionslanguage_code": [ "<div>...</div>"
              {},
              "labelfeedback_2": {
                "language_code": "<p>Floral organs</p><div>...</div>"
              },
             
"value": 0             },
            "solutions": {
              "labelsolution_1": {
                "language_code": "<p>Veins and veinlets in a lamina</p>: "<div>...</div>"
              },
              "valuesolution_2": 1{
            }    "language_code": "<div>...</div>"
     ]         },
            },
"validation": {           "requiredinteractions": {
"Yes"          }    "response1": {
 }     }   }
}

the read api transforms data created using v1 api’s or spec-1 of v2 api’s. It injects default language code configured in the system and return the response to user.
same transformation will be applicable in Question List API

Question Update API:

Question Update API also support both spec as mentioned in create api.
For older data (created with v1 api’s), on v2 api update call, data will be migrated to v2 api format as well as version will be set to 2.

Request_1:

Code Block

language	json

{
  "request": {
    "question": {       "type": "choice",
                "options": [
                 "name": "updated_question_title", {
      "versionKey": "1234",       "body": "question body as string when question can be used in only one language.","label": {
            "instructions": {         "language_code": "<p>Wheat</p>"instructions
in HTML format."       },
      "answer": "answer",     },
 "hints": [         "hint-1",         "hint-2"value": 1
       ],       "feedback": {   },
     "feedback_id_1": "feedback-1",         "feedback_id_2": "feedback-2"  {
    },       "solutions": [        "label": {
          "id": "bc6e4294-1a19-4e75-fb43-871f0e54b0e8",           "typelanguage_code": "html",
 <p>Barley</p>"
        "value": "solution in HTML format"         },
        {           "id": "bc6e4294-1a19-4e75-fb43-871f0e54b0e9",
 value": 2
        "type": "html",         },
 "value": "a question can have more than one solution. in such cases, another solution in HTML format"  {
      }       ],       "interactionslabel": {
        "response1": {              "typelanguage_code": "choice",<p>Maize</p>"
            "options": [       },
     {               "labelvalue": "<p>Floral organs</p>", 3
                  },
                  {
  "value": 0             },    "label": {
       {               "labellanguage_code": "<p>Veins and veinlets in a lamina<<p>Tea</p>",
              "value": 1     },
       }           ]  "value": 4
     },         "validation": {   }
       "required": "Yes"        ],
}       }     }   }
}

Request_2:

Code Block

language	json

 "validation": {
  "request": {        "question": {       "namerequired": "updated_question_title",Yes"
        "versionKey": "1234",       "body":}
{         "language_code_1": "question body as string in}
specified language."       },    },
  "instructions": {         "language_coderesponseDeclaration": "instructions{
in HTML format."       },       "answerresponse1": {
                "language_codecardinality": "answersingle",
in specified language"       },       "hintstype": { "integer",
                "language_codecorrectResponse": [
  {
       "hint-1",           "hint-2value": 3
       ]         },
      "feedback": {         "feedback_id_1mapping": {[
          "language_code": "feedback-1"       {
 },         "feedback_id_2": {           "language_codevalue": "feedback-2"
 2,
      }       },       "solutionsscore": {
   0.5
    "language_code": [           {     },
       "id": "bc6e4294-1a19-4e75-fb43-871f0e54b0e8",           {
      "type": "html",             "value": "solution1,
in HTML format"           },       "score": 0.25
  {             "id": "bc6e4294-1a19-4e75-fb43-871f0e54b0e9",  }
          "type": "html",      ]
      "value": "a question can have more than one solution.}
in such cases, another solution in HTML format"     },
     }       "outcomeDeclaration": {
]       },       "interactionsmaxScore": {
   
    "response1": {           "typecardinality": "choicesingle",
          "options": [     "type": "integer",
      {          "defaultValue": 3
   "label": {          }
      "language_code": "<p>Floral organs</p>"    }
          },
          "objectType": "Question",
   "value":  0     "root": false,
      },    "isNew": true
       { }
      },
      "labelhierarchy": {
           "questionset_identifier": {
    "language_code": "<p>Veins and veinlets in a lamina</p>"children": [
            "q1"
},          ],
    "value": 1     "root": true
      }  }
      }
 ]   }
  }
}

Sample Success Response:

Code Block

language	json

{
 },   "id": "api.questionset.hierarchy.update",
    "validationver": {"5.0",
    "ts": "2023-05-08T07:03:25ZZ",
    "requiredparams": "Yes"{
         }"resmsgid": "deb89409-5775-4970-921d-1298f99dafa7",
      }  "msgid": null,
 }   } }

Response:

Code Block

language	json

{
    "iderr": "api.question.update"null,
        "verstatus": "5.0successful",
    "ts": "2023-01-30T19:43:43ZZ",     "paramserrmsg": null
{    },
    "resmsgidresponseCode": "ca1ed6b6-994d-487c-8ecd-0ca164a84c94OK",

       "msgidresult": null,{
        "erridentifier": null"do_21379147288621056013168",
        "statusidentifiers": "successful", {
            "errmsgq1": null"do_21379147288888115213169"
    },    }
"responseCode": "OK",     "result": {
        "identifier": "do_2137224832856555521270",
        "versionKey": "1675107822985"
    }
}

...

}
}

data transformation will be done for questions data supplied in single language under request.
- if question data is provided without language information, default language will be stamped.

QuestionSet Update API:

there is no change in spec from v1 to v2 api.
For older questionset having qumlVersion 1.0, v2 api will auto migrate to quml spec 1.1.

QuestionSet Review API:

there is no change in spec from v1 to v2 api.
For older data, the api will throw client error if the object qumlVersion is 1.0.
All children should belong to same qumlVersion as per Questionset. ????

QuestionSet Publish API:

there is no change in spec from v1 to v2 api.
For older data, the api will throw client error if the object qumlVersion is 1.0.

QuestionSet Retire API:

there is no change in spec from v1 to v2 api.
there is no change for logical behaviour of the api

Question Publish QuestionSet Copy API:

there is no change in spec from v1 to v2 api.
the api will support copy operation only if object qumlVersion match with default qumlVersion supported by the micro-service.
For older data, the api will throw client error if the data version qumlVersion is 1.

Question Copy API:

there is no change in spec from v1 to v2 api.
if source object version is 1, copied data will be created using v2 format.

QuestionSet API’s:

...

0. First the data should be migrated.

Versions Compared

Old Version 6

New Version Current

Key

Sample Input for single language: