/query/diseaseWithFewerDisnetConcepts

  • Description

    Retrieve disease(s) with fewer 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/diseaseWithFewerDisnetConcepts?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/diseaseWithFewerDisnetConcepts?source=wikipedia&version=2018-09-01&limit=2&validated=&excludeSemanticTypes=&forceSemanticTypes=&token=eyJhbGciOiJI...
                                         
                                    
  • Success response (application/json)
                                        
                                            {
                                                "token": "eyJhbGciOiJI...",
                                                "authorized": true,
                                                "authorizationMessage": "Authorized!",
                                                "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)