/query/diseaseWithMoreDisnetConcepts
-
Description
Retrieve disease(s) with more DISNET Concepts for a given source and snapshot. It is possible to exclude or force certain semantic types, Optionally, it can be shown: the codes associated with the disease, and the number of times a DISNET Concept has been found in the disease's texts. Finally, there is also the possibility to only retrieve the DISNET Concepts that have been filtered with our TVP procedure.
-
URL (PATH)
/query/diseaseWithMoreDisnetConcepts?source=:source&version=:version&validated=:validated&limit=:limit&excludeSemanticTypes=:excludeSemanticTypes&forceSemanticTypes=:forceSemanticTypes&detectionInformation=:detectionInformation&includeCode=:includeCode&token=:token
-
Method
GET
-
Auth required
Optional (token)
-
Request parameters
Parameter Description source *required
[alphanumeric]
example: source=wikipediaName of the information source. version *required
[alphanumeric with format “aaaa-mm-dd”]
example: version=2018-09-15Date of information source extraction, in "yyyy-mm-dd" format. validated
[boolean] by default always is true
example: validated=falseShow DISNET Concepts filtered by our TVP process. limit
[integer] by default always is 10
example: limit=2Show DISNET Concepts filtered by our TVP process. excludeSemanticTypes
[alphanumeric]
example: excludeSemanticTypes=dsyn,sosyExcludes the semantic type or types defined. If there are more than one, they are separated by commas (,). forceSemanticTypes
[alphanumeric]
example: forceSemanticTypes=dsyn,sosyIt forces the semantic type or types defined. If there are more than one, they are separated by commas (,). detectionInformation
[boolean] by default always is false
example: detectionInformation=trueShows the number of times the DISNET Concept has been found in the disease texts. includeCode
[boolean] by default always is false
example: includeCode=trueShows the disease codes in sources external to DISNET. token
[alphanumeric]
example: token=eyJhbGciOiJI...Optional access key to save the current query inside the user's profile -
Important
A correct request can only be made if the excludeSemanticTypes=true parameter and the forceSemanticTypes=false parameter are used, both cannot be true.
-
Example request
GET http://disnet.ctb.upm.es/api/disnet/query/diseaseWithMoreDisnetConcepts?source=wikipedia&version=2018-09-01&limit=2&validated=true&excludeSemanticTypes=&forceSemanticTypes=sosy,diap&token=
-
Success response (application/json)
{ "token": null, "authorized": false, "authorizationMessage": null, "responseCode": "200", "responseMessage": "OK", "errorsFound": [], "diseaseCount": 2, "diseaseList": [ { "diseaseId": "DIS007840", "name": "Kawasaki disease", "url": "http://en.wikipedia.org/wiki/Kawasaki_disease", "disnetConceptsCount": 25, "disnetConceptList": [ { "cui": "C0221423", "name": "Illness (finding)", "semanticTypes": [ "sosy" ] }, { "cui": "C0013516", "name": "Echocardiography", "semanticTypes": [ "diap" ] }, { "cui": "C0015230", "name": "Exanthema", "semanticTypes": [ "sosy" ] }, { "cui": "C0085532", "name": "Coronary angiography", "semanticTypes": [ "diap" ] }, { "cui": "C0235267", "name": "Redness of eye", "semanticTypes": [ "sosy" ] }, { "cui": "C0002978", "name": "Angiogram", "semanticTypes": [ "diap" ] }, { "cui": "C0041618", "name": "Ultrasonography", "semanticTypes": [ "diap" ] }, { "cui": "C1623258", "name": "Electrocardiography", "semanticTypes": [ "diap" ] }, { "cui": "C0030193", "name": "Pain", "semanticTypes": [ "sosy" ] }, { "cui": "C0000737", "name": "Abdominal pain", "semanticTypes": [ "sosy" ] }, { "cui": "C0003862", "name": "Arthralgia", "semanticTypes": [ "sosy" ] }, { "cui": "C0008031", "name": "Chest pain NOS", "semanticTypes": [ "sosy" ] }, { "cui": "C0011991", "name": "Diarrhea", "semanticTypes": [ "sosy" ] }, { "cui": "C0023380", "name": "Lethargy", "semanticTypes": [ "sosy" ] }, { "cui": "C0042963", "name": "Vomiting", "semanticTypes": [ "sosy" ] }, { "cui": "C0263534", "name": "Beau's lines", "semanticTypes": [ "sosy" ] }, { "cui": "C0392171", "name": "Influenza-like symptoms", "semanticTypes": [ "sosy" ] }, { "cui": "C0033774", "name": "Pruritus", "semanticTypes": [ "sosy" ] }, { "cui": "C0010200", "name": "Coughing", "semanticTypes": [ "sosy" ] }, { "cui": "C0018681", "name": "Headache", "semanticTypes": [ "sosy" ] }, { "cui": "C0036572", "name": "Convulsions", "semanticTypes": [ "sosy" ] }, { "cui": "C1260880", "name": "Rhinorrhea", "semanticTypes": [ "sosy" ] }, { "cui": "C0000727", "name": "Acute abdomen", "semanticTypes": [ "sosy" ] }, { "cui": "C0007758", "name": "Cerebellar ataxia NOS", "semanticTypes": [ "sosy" ] }, { "cui": "C0018991", "name": "Hemiplegia", "semanticTypes": [ "sosy" ] } ] }, { "diseaseId": "DIS004124", "name": "Hypoglycemia", "url": "http://en.wikipedia.org/wiki/Hypoglycemia", "disnetConceptsCount": 28, "disnetConceptList": [ { "cui": "C0221423", "name": "Illness (finding)", "semanticTypes": [ "sosy" ] }, { "cui": "C0018681", "name": "Headache", "semanticTypes": [ "sosy" ] }, { "cui": "C0020175", "name": "Hunger", "semanticTypes": [ "sosy" ] }, { "cui": "C0026961", "name": "Mydriasis", "semanticTypes": [ "sosy" ] }, { "cui": "C0027497", "name": "Nausea", "semanticTypes": [ "sosy" ] }, { "cui": "C0040822", "name": "Tremor", "semanticTypes": [ "sosy" ] }, { "cui": "C0042963", "name": "Vomiting", "semanticTypes": [ "sosy" ] }, { "cui": "C0232487", "name": "Abdominal discomfort", "semanticTypes": [ "sosy" ] }, { "cui": "C0004134", "name": "Ataxia", "semanticTypes": [ "sosy" ] }, { "cui": "C0012833", "name": "Dizziness", "semanticTypes": [ "sosy" ] }, { "cui": "C0015672", "name": "Fatigue", "semanticTypes": [ "sosy" ] }, { "cui": "C0018989", "name": "Hemiparesis", "semanticTypes": [ "sosy" ] }, { "cui": "C0023380", "name": "Lethargy", "semanticTypes": [ "sosy" ] }, { "cui": "C0028643", "name": "Numbness", "semanticTypes": [ "sosy" ] }, { "cui": "C0085632", "name": "Apathy", "semanticTypes": [ "sosy" ] }, { "cui": "C0085635", "name": "Photopsia", "semanticTypes": [ "sosy" ] }, { "cui": "C0240735", "name": "Personality change", "semanticTypes": [ "sosy" ] }, { "cui": "C0344232", "name": "Blurred vision", "semanticTypes": [ "sosy" ] }, { "cui": "C0520966", "name": "Abnormal coordination", "semanticTypes": [ "sosy" ] }, { "cui": "C0751295", "name": "Loss of memory", "semanticTypes": [ "sosy" ] }, { "cui": "C0751495", "name": "Focal seizure", "semanticTypes": [ "sosy" ] }, { "cui": "C3714552", "name": "Weakness", "semanticTypes": [ "sosy" ] }, { "cui": "C0231218", "name": "Malaise", "semanticTypes": [ "sosy" ] }, { "cui": "C0010520", "name": "Cyanosis", "semanticTypes": [ "sosy" ] }, { "cui": "C0027066", "name": "Myoclonus", "semanticTypes": [ "sosy" ] }, { "cui": "C0036572", "name": "Convulsions", "semanticTypes": [ "sosy" ] }, { "cui": "C0476273", "name": "Respiratory distress", "semanticTypes": [ "sosy" ] }, { "cui": "C0028084", "name": "Nightmares", "semanticTypes": [ "sosy" ] } ] } ] }
-
Error response (application/json)
Common errors