Please note that at this current time, these services are not available for use in a live environment and must not be used. The following information is made available in advance of go-live
At this time, the live APIs and algorithms are not yet registered as devices by the MHRA.
Background
Information about the research and algorithms that resulted in QDiabetes, as well as the free to use Web site can be viewed at https://qdiabetes.org/
Predict Services
QDiabetes risk score can be calculated using Endeavour Predict services, which consist of:
- A set of Web based APIs for submitting requests for a prediction and receiving a response, the response including a risk score, and other score specific information
- A set of FHIR APIS to enable system suppliers to know which Snomed-CT concepts should be used when deriving information from records. These are part of the Endeavour information model services.
- A REST API for deriving a Townsend deprivation score from a post code, the Townsend score being then submitted as part of the QRISK request payload.
- Source code repositories of open source code used by 1) and 2) and 3)
Concept sets
Concept sets for use in QDiabetes can be seen in the Endeavour Information manager at
http://apiqcodes.org/qcodes#QPredict_350
In line with FHIR an semantic web standards, each set is given a unique IRI and it is the IRI that is used as identifiers in the API call
Alternatively, the concept sets can be downloaded from the IM application in excel CSV , or TSV
Within Endeavour each concept is given a unique identifier or IRI in line with semantic Web. Users will be more familiar with the use of the concept's code and this is provided as well as maps to alternative code schemes.
APIs
A developer portal for QDiabetes is available at https://dev.endeavourpredict.org/
With FHIR value sets at
https://im.endhealth.co.uk/nodeapi/doc/#/default/get_ValueSet
The concepts sets contain subsets so that recursive calls can be made to obtain each set. Alternatively, using the $expand operation, the entire subset can be obtained as one.
Source code
The source code for the APIs can be viewed on Github at
https://github.com/endeavour-predict/qdiabetes-dotnet
Note that the source code is made available under the GNU public license.
However, the use of QDiabetes as a registered trademark is not an open license and terms and conditions apply to its use.
Query Rules for health records
Systems may have access to longitudinal health records, in particular those held in General Practice. In that case those systems may elect to query the health record data in a way that provides likely values for the variables, passed to the function as parameters to the QDiebetes function.
In this case, a set of query criteria and rules are applied to the record entries and the values of the variables derived from those entries. These are then presented to a user for confirmation or amendment before being submitted via the API.
It is strongly recommended that for any individual decision, or when an entry of a risk score is into a record is being considered, that each set of assumptions are confirmed by the user. However, purely automated calculations may be used for population based risk stratification.
Reference date
Scores may be calculated in real time or retrospectively. The reference date (current date or past date) is used for all time dependent values, which means values as they would have been on the reference date. For example when looking for dates within 6 months this means 6 months prior to, or at the time of, the reference date and all entries subsequent are ignored.
Query rules to follow