/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=wikipedia
    Name of the information source.
    version *required
    [alphanumeric with format “aaaa-mm-dd”]
    example: version=2018-09-15
    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
    [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)