/query/diseaseWithMoreDisnetConcepts

  • Description

    Retrieve disease(s) with more DISNET Concepts for a given source and snapshot. Excludes or forcing semantic types, it adds an option to show or not the codes associated with the disease and to show the number of times the DISNET Concept has been found in the disease texts and finally allowed retrieve that DISNET Concepts that were filtered by 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

    Yes (token)

  • Request parameters
    Parameter Description
    source *required
    [alphanumeric]
    example: source=wikipedia
    Name of the information source.
    version *required
    [alphanumeric with format “aaaa-mm-dd”]
    example: token=eyJhbGciOiJI...
    Date of information source extraction, in "yyyy-mm-dd" format.
    validated
    [boolean] by default always is true
    example: validated=false
    Show DISNET Concepts filtered by our TVP process.
    limit
    [integer] by default always is 10
    example: limit=2
    Show DISNET Concepts filtered by our TVP process.
    excludeSemanticTypes
    [alphanumeric]
    example: excludeSemanticTypes=dsyn,sosy
    Excludes the semantic type or types defined. If there are more than one, they are separated by commas (,).
    forceSemanticTypes
    [alphanumeric]
    example: forceSemanticTypes=dsyn,sosy
    It 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=true
    Shows the number of times the DISNET Concept has been found in the disease texts.
    includeCode
    [boolean] by default always is false
    example: includeCode=true
    Shows the disease codes in sources external to DISNET.
    token *required
    [alphanumeric]
    example: token=eyJhbGciOiJI...
    Access key that allows the query to be executed.
  • Important

    A correct request can only be made if the excludeSemanticTypes=true parameter and the forceSemanticTypes=false parameter are used, both cannot have the true value.

  • 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=eyJhbGciOiJI...
                                         
                                    
  • Success response (application/json)
                                        
                                            {
                                                "token": "eyJhbGciOiJI...",
                                                "authorized": true,
                                                "authorizationMessage": "Authorized!",
                                                "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