Doctorlink has joined HealthHerohealthheroLearn More
doctorlink

Question summary

The question summary endpoint (ReDoc) allows you to get a full list of questions the user has seen on their journey through the product. This will exclude questions that were Preanswered by injecting history.

curl ".../api/v1/{tenantId}/Traversals/{traversalId}/questions" \
  -X "GET" \
  -H "Authorization: Bearer ACCESS_TOKEN" \

Using this data packet you can allow users to revisit questions they've seen, and re-answer them, with the exception of nodes that specifically request you not to allow it in the response's previousDisabled property. Once you've received a node with previousDisabled: true you should not allow the user to go back to any previous questions.

The summary could look something like this:

question-summary.png

This actionable summary was made using the below sample code. This sample contains all the seen questions and all the answers, including non-selected answers. This is because you may want to show the negatives (the answers not selected) as well the positives (the answers selected).

[
   {
      "algoId":2,
      "nodeId":163,
      "assetId":70,
      "groupId":200157,
      "displayText":"Gender:",
      "summaryText":"Gender",
      "clinicalText":"Gender",
      "answers":[
         {
            "id":"8cd74ac9-77b8-4d5c-ab3b-a017a71b5cc6",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":2,
            "groupId":200157,
            "nodeId":163,
            "assetId":70,
            "nodeTypeId":34,
            "nodeType":"GenderCheck",
            "answerId":88,
            "nextNodeId":160,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:24:57.0767514Z",
            "displayText":"Male",
            "summaryText":"Male",
            "clinicalText":"Male",
            "isAnswered":true
         },
         {
            "id":"1fdc4119-c007-4c16-98cc-e7076cb9e80d",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":2,
            "groupId":200157,
            "nodeId":163,
            "assetId":70,
            "nodeTypeId":34,
            "nodeType":"GenderCheck",
            "answerId":89,
            "nextNodeId":160,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:24:57.0767514Z",
            "displayText":"Female",
            "summaryText":"Female",
            "clinicalText":"Female",
            "isAnswered":false
         }
      ]
   },
   {
      "algoId":2,
      "nodeId":160,
      "assetId":19063,
      "groupId":200157,
      "displayText":"Enter the patient's date of birth",
      "summaryText":"Enter your date of birth",
      "clinicalText":"Enter your date of birth",
      "answers":[
         {
            "id":"6efb2494-a1b5-46f1-9fe8-4781710be170",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":2,
            "groupId":200157,
            "nodeId":160,
            "assetId":19063,
            "nodeTypeId":35,
            "nodeType":"AgeCheck",
            "answerId":19225,
            "nextNodeId":1000160,
            "value":"1980-01-01",
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:24:57.0767514Z",
            "displayText":"DOB (dd/mm/yyyy).",
            "summaryText":"*",
            "clinicalText":"Age enter",
            "isAnswered":true
         }
      ]
   },
   {
      "algoId":2,
      "nodeId":2,
      "assetId":3200,
      "groupId":0,
      "displayText":"What kind of health assessment would you like to complete?",
      "summaryText":"",
      "clinicalText":"Health assessment choice",
      "answers":[
         {
            "id":"4c12e16e-9058-46fc-90ed-55e6621c910e",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":2,
            "groupId":0,
            "nodeId":2,
            "assetId":3200,
            "nodeTypeId":32,
            "nodeType":"Exclusive",
            "answerId":3810,
            "nextNodeId":42,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:25:06.6942046Z",
            "displayText":"Full health risk and well-being assessment",
            "summaryText":"Full health risk and well-being assessment",
            "clinicalText":"Full health risk and well-being assessment",
            "isAnswered":true
         },
         {
            "id":"fb37ff59-bda0-48b4-b053-473f5f65e498",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":2,
            "groupId":0,
            "nodeId":2,
            "assetId":3200,
            "nodeTypeId":32,
            "nodeType":"Exclusive",
            "answerId":3813,
            "nextNodeId":8,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:25:06.6942046Z",
            "displayText":"A specific well-being assessment",
            "summaryText":"A specific well-being assessment",
            "clinicalText":"A specific well-being assessment",
            "isAnswered":false
         },
         {
            "id":"c0c12f4c-b5dc-46b6-b296-71a0e6dabab3",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":2,
            "groupId":0,
            "nodeId":2,
            "assetId":3200,
            "nodeTypeId":32,
            "nodeType":"Exclusive",
            "answerId":3814,
            "nextNodeId":23,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:25:06.6942046Z",
            "displayText":"A specific health risk assessment",
            "summaryText":"A specific health risk assessment",
            "clinicalText":"A specific health risk assessment",
            "isAnswered":false
         }
      ]
   },
   {
      "algoId":3865,
      "nodeId":343,
      "assetId":1508,
      "groupId":0,
      "displayText":"In general, compared to other people your age, would you say your health is:",
      "summaryText":"Compared to others of the same age, self-perceived health status is rated as",
      "clinicalText":"Self-perceived health status compared to others the same age",
      "answers":[
         {
            "id":"62941f49-838d-4b20-9144-a15b20d2b631",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":3865,
            "groupId":0,
            "nodeId":343,
            "assetId":1508,
            "nodeTypeId":32,
            "nodeType":"Exclusive",
            "answerId":4934,
            "nextNodeId":1598,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:25:10.2772843Z",
            "displayText":"Excellent",
            "summaryText":"Excellent",
            "clinicalText":"Excellent",
            "isAnswered":false
         },
         {
            "id":"2c2f712c-7587-4618-8fc3-22e85ef706de",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":3865,
            "groupId":0,
            "nodeId":343,
            "assetId":1508,
            "nodeTypeId":32,
            "nodeType":"Exclusive",
            "answerId":10553,
            "nextNodeId":1598,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:25:10.2772843Z",
            "displayText":"Very good",
            "summaryText":"Very good",
            "clinicalText":"Very Good",
            "isAnswered":false
         },
         {
            "id":"9f24f86f-d168-42f9-96b2-92994aebc170",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":3865,
            "groupId":0,
            "nodeId":343,
            "assetId":1508,
            "nodeTypeId":32,
            "nodeType":"Exclusive",
            "answerId":10554,
            "nextNodeId":1598,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:25:10.2772843Z",
            "displayText":"Good",
            "summaryText":"Good",
            "clinicalText":"Good",
            "isAnswered":true
         },
         {
            "id":"76253b66-35fe-44c2-8937-f66f7a70e474",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":3865,
            "groupId":0,
            "nodeId":343,
            "assetId":1508,
            "nodeTypeId":32,
            "nodeType":"Exclusive",
            "answerId":10555,
            "nextNodeId":1598,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:25:10.2772843Z",
            "displayText":"Fair",
            "summaryText":"Fair",
            "clinicalText":"Fair",
            "isAnswered":false
         },
         {
            "id":"9d512f6d-7f5e-4c62-a3e4-75e895b9ca17",
            "traversalId":"34dd96f3-9fd7-4514-8587-1039de86039a",
            "algoId":3865,
            "groupId":0,
            "nodeId":343,
            "assetId":1508,
            "nodeTypeId":32,
            "nodeType":"Exclusive",
            "answerId":10556,
            "nextNodeId":1598,
            "value":null,
            "counter":0.0,
            "previousCounter":0.0,
            "createdDateTime":"2020-07-16T14:25:10.2772843Z",
            "displayText":"Poor",
            "summaryText":"Poor",
            "clinicalText":"Poor",
            "isAnswered":false
         }
      ]
   }
]