/query/diseaseList

  • Description

    Retrieve diseases list for a given source and snapshot. For each retrieved disease you get: the DISNET ID of the disease, the name, the Web link, and the list of disease codes in sources external to DISNET.

  • URL (PATH)

    /query/diseaseList?source=:source&version=:version&size=:size&page=:page&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.
    size
    [integer] by default always is 20
    example: size=25
    First parameter of two, that manage the pagination; it is relative to the number of records to be displayed per page.
    page
    [integer] by default always is 0
    example: page=3
    Second parameter of two, that manage the pagination; it is relative to the number of the page to be displayed.
    token *required
    [alphanumeric]
    example: token=eyJhbGciOiJI...
    Access key that allows the query to be executed.
  • Example request
                                         
                                             GET http://disnet.ctb.upm.es/api/disnet/query/diseaseList?source=wikipedia&version=2018-09-15&size=20&page=0&token=eyJhbGciOiJI...
                                         
                                    
  • Success response (application/json)
                                        
                                            {
                                                "content": [
                                                    {
                                                        "diseaseId": "DIS004692",
                                                        "name": "17q21.31 microdeletion syndrome",
                                                        "url": "http://en.wikipedia.org/wiki/17q21.31_microdeletion_syndrome",
                                                        "codesCount": 2,
                                                        "codes": [
                                                            {
                                                                "code": "17q21.31 microdeletion syndrome",
                                                                "typeCode": "GeneReviews"
                                                            },
                                                            {
                                                                "code": "610443",
                                                                "typeCode": "OMIM"
                                                            }
                                                        ],
                                                        "disnetConceptsCount": 0
                                                    },
                                                    {
                                                        "diseaseId": "DIS007340",
                                                        "name": "17β-Hydroxysteroid dehydrogenase III deficiency",
                                                        "url": "http://en.wikipedia.org/wiki/17-beta-hydroxysteroid_dehydrogenase_deficiency",
                                                        "codesCount": 3,
                                                        "codes": [
                                                            {
                                                                "code": "264300",
                                                                "typeCode": "OMIM"
                                                            },
                                                            {
                                                                "code": "32638",
                                                                "typeCode": "DiseasesDB"
                                                            },
                                                            {
                                                                "code": "752",
                                                                "typeCode": "Orphanet"
                                                            }
                                                        ],
                                                        "disnetConceptsCount": 3
                                                    },
                                                    {
                                                        "diseaseId": "DIS005265",
                                                        "name": "18p-",
                                                        "url": "http://en.wikipedia.org/wiki/18p-",
                                                        "codesCount": 1,
                                                        "codes": [
                                                            {
                                                                "code": "146390",
                                                                "typeCode": "OMIM"
                                                            }
                                                        ],
                                                        "disnetConceptsCount": 2
                                                    },
                                                    {
                                                        "diseaseId": "DIS003113",
                                                        "name": "1p36 deletion syndrome",
                                                        "url": "http://en.wikipedia.org/wiki/1p36_deletion_syndrome",
                                                        "codesCount": 2,
                                                        "codes": [
                                                            {
                                                                "code": "34535",
                                                                "typeCode": "DiseasesDB"
                                                            },
                                                            {
                                                                "code": "607872",
                                                                "typeCode": "OMIM"
                                                            }
                                                        ],
                                                        "disnetConceptsCount": 42
                                                    },
                                                    {
                                                        "diseaseId": "DIS007075",
                                                        "name": "1q21.1 deletion syndrome",
                                                        "url": "http://en.wikipedia.org/wiki/1q21.1_deletion_syndrome",
                                                        "codesCount": 2,
                                                        "codes": [
                                                            {
                                                                "code": "1q211-microdeletion",
                                                                "typeCode": "MedlinePlus"
                                                            },
                                                            {
                                                                "code": "612474",
                                                                "typeCode": "OMIM"
                                                            }
                                                        ],
                                                        "disnetConceptsCount": 10
                                                    },
                                                    {
                                                        "diseaseId": "DIS006629",
                                                        "name": "1q21.1 duplication syndrome",
                                                        "url": "http://en.wikipedia.org/wiki/1q21.1_duplication_syndrome",
                                                        "codesCount": 1,
                                                        "codes": [
                                                            {
                                                                "code": "612475",
                                                                "typeCode": "OMIM"
                                                            }
                                                        ],
                                                        "disnetConceptsCount": 9
                                                    },
                                                    {
                                                        "diseaseId": "DIS006819",
                                                        "name": "2,4 Dienoyl-CoA reductase deficiency",
                                                        "url": "http://en.wikipedia.org/wiki/2,4_Dienoyl-CoA_reductase_deficiency",
                                                        "codesCount": 1,
                                                        "codes": [
                                                            {
                                                                "code": "222745",
                                                                "typeCode": "OMIM"
                                                            }
                                                        ],
                                                        "disnetConceptsCount": 0
                                                    },
                                                    ...
                                                ],
                                                "token": "eyJhbGciOiJI...",
                                                "authorized": true,
                                                "authorizationMessage": "Authorized!",
                                                "responseCode": "200",
                                                "responseMessage": "OK",
                                                "errorsFound": [],
                                                "totalElements": 5862,
                                                "last": false,
                                                "totalPages": 294,
                                                "first": false,
                                                "sort": null,
                                                "numberOfElements": 20,
                                                "size": 20,
                                                "number": 0
                                            }
                                        
                                    
  • Error response (application/json)

    Common errors