/query/diseaseWithFewerDisnetConcepts
-
Description
Retrieve disease(s) with fewer 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/diseaseWithFewerDisnetConcepts?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/diseaseWithFewerDisnetConcepts?source=wikipedia&version=2018-09-01&limit=2&validated=&excludeSemanticTypes=&forceSemanticTypes=&token=
-
Success response (application/json)
{ "token": null, "authorized": false, "authorizationMessage": null, "responseCode": "200", "responseMessage": "OK", "errorsFound": [], "diseaseCount": 2, "diseaseList": [ { "diseaseId": "DIS003903", "name": "Short-chain acyl-coenzyme A dehydrogenase deficiency", "url": "http://en.wikipedia.org/wiki/Short-chain_acyl-coenzyme_A_dehydrogenase_deficiency", "disnetConceptsCount": 1, "disnetConceptList": [ { "cui": "C0042014", "name": "Urinalysis", "semanticTypes": [ "lbpr" ] } ] }, { "diseaseId": "DIS006930", "name": "Heterophoria", "url": "http://en.wikipedia.org/wiki/Heterophoria", "disnetConceptsCount": 1, "disnetConceptList": [ { "cui": "C0038379", "name": "Strabismus", "semanticTypes": [ "dsyn" ] } ] } ] }
-
Error response (application/json)