API

Concepts:

  1. List/Search concepts

  2. Lists the published concepts.

    get /api/v1/public/concepts/

    User can search with criteria using a combinations of querystring parameters:

    • ?search=Alcohol
      search by part of concept name (do not put wild characters here)
    • ?tag_ids=11,4
      You can specify tags ids (get tags from /api/v1/tags/)
    • ?show_only_validated_concepts=1
      will show only validated concepts
    • ?brand=HDRUK
      will show only concepts with brand=HDRUK
    • ?author=Kuan
      search by part of the author name
    • ?do_not_show_versions=1
      do not show concepts versions (by default, all concept's version ids are shown)
    (Example: /api/v1/public/concepts/?author=m&brand=adp&tag_ids=11)

  3. List concept by id

  4. Lists a published concepts by id.

    get /api/v1/public/concepts/{id}/
  5. List concept detail (latest version)

  6. Lists the pubished concept detail of the latest published version.

    get /api/v1/public/concepts/{id}/detail/
  7. List concept detail (of a specific version)

  8. Lists the published concept detail of the specified published version.

    get /api/v1/public/concepts/{id}/version/{version_id}/detail/
  9. Export the code list of a specific version of a concept

  10. Exports the code list of a specific version of a published concept.

    get /api/v1/public/concepts/{id}/version/{version_id}/export/codes/
  11. List the versions of a concept

  12. Lists the published versions of the published concept .

    get /api/v1/public/concepts/{id}/get-versions/

Authenticated APIs:

  1. List/Search concepts

  2. Lists all available concepts for the user.

    get /api/v1/concepts/

    User can search with criteria using a combinations of querystring parameters:

    • ?search=Alcohol
      search by part of concept name (do not put wild characters here)
    • ?tag_ids=11,4
      You can specify tags ids (get tags from /api/v1/tags/)
    • ?show_only_my_concepts=1
      Only show concepts owned by me
    • ?show_deleted_concepts=1
      will show also deleted concepts (by default, deleted objects are not shown)
    • ?show_only_validated_concepts=1
      will show only validated concepts
    • ?brand=HDRUK
      will show only concepts with brand=HDRUK
    • ?author=Kuan
      search by part of the author name
    • ?owner_username=a.john
      search by full username of the owner
    • ?do_not_show_versions=1
      do not show concepts versions (by default, all concept's version ids are shown)
    • ?must_have_published_versions=1
      show only concepts which have a published version(by default, all concepts are shown)
    (Example: /api/v1/concepts/?author=m&brand=adp&tag_ids=11)

  3. List concept by id

  4. Lists a concept by id for the user.

    get /api/v1/concepts/{id}/
  5. List concept detail (latest version)

  6. Lists the concept detail of the latest version.

    get /api/v1/concepts/{id}/detail/
  7. List concept detail (of a specific version)

  8. Lists the concept detail of the specified version.

    get /api/v1/concepts/{id}/version/{version_id}/detail/
  9. Export the code list of a specific version of a concept

  10. Exports the code list of the latest version of a concept for the user.

    get /api/v1/concepts/{id}/export/codes/

    Exports the code list of a specific version of a concept for the user.

    get /api/v1/concepts/{id}/version/{version_id}/export/codes/
  11. List the versions of a concept

  12. Lists all the versions of the concept for the user.

    get /api/v1/concepts/{id}/get-versions/
  13. Create/Update a concept

  14. Create a concept by passing a JSON object.

    post /api/v1/api_concept_create/

    Update a concept by passing a JSON object.

    put /api/v1/api_concept_update/

Phenotypes:

  1. List/Search phenotypes

  2. Lists the published phenotypes and the data sources associated with each.

    get /api/v1/public/phenotypes/

    User can search with criteria using a combinations of querystring parameters:

    • ?search=Alcohol
      search by part of phenotype name (do not put wild characters here)
    • ?tag_ids=11,4
      You can specify tags ids (get tags from /api/v1/tags/)
    • ?show_only_validated_phenotypes=1
      will show only validated phenotypes
    • ?brand=HDRUK
      will show only phenotypes with brand=HDRUK (this overwrites the site default brand)
    • ?author=Kuan
      search by part of the author name
    • ?do_not_show_versions=1
      do not show phenotypes versions (by default, all phenotype's version ids are shown)
    (Example: /api/v1/public/phenotypes/?author=m&brand=adp&tag_ids=11)

  3. List phenotype by id

  4. Lists a published phenotypes by id and the data sources associated with it.

    get /api/v1/public/phenotypes/{id}/
  5. List phenotype detail (latest version)

  6. Lists the pubished phenotype detail of the latest published version.

    get /api/v1/public/phenotypes/{id}/detail/
  7. List phenotype detail (of a specific version)

  8. Lists the published phenotype detail of the specified published version.

    get /api/v1/public/phenotypes/{id}/version/{version_id}/detail/
  9. Export the code list of a specific version of a phenotype

  10. Exports the code list of a specific version of a published phenotype.

    get /api/v1/public/phenotypes/{id}/version/{version_id}/export/codes/
  11. List the versions of a phenotype

  12. Lists the published versions of the published phenotype .

    get /api/v1/public/phenotypes/{id}/get-versions/

Authenticated APIs:

  1. List/Search phenotypes

  2. Lists all available phenotypes for the user and the data sources associated with each.

    get /api/v1/phenotypes/

    User can search with criteria using a combinations of querystring parameters:

    • ?search=Alcohol
      search by part of phenotype name (do not put wild characters here)
    • ?tag_ids=11,4
      You can specify tags ids (get tags from /api/v1/tags/)
    • ?show_only_my_phenotypes=1
      Only show phenotypes owned by me
    • ?show_deleted_phenotypes=1
      will show also deleted phenotypes (by default, deleted objects are not shown)
    • ?show_only_validated_phenotypes=1
      will show only validated phenotypes
    • ?brand=HDRUK
      will show only phenotypes with brand=HDRUK (this overwrites the site default brand)
    • ?author=Kuan
      search by part of the author name
    • ?owner_username=a.john
      search by full username of the owner
    • ?do_not_show_versions=1
      do not show phenotypes versions (by default, all phenotype's version ids are shown)
    • ?must_have_published_versions=1
      show only phenotypes which have a published version(by default, all phenotypes are shown)
    (Example: /api/v1/phenotypes/?author=m&brand=adp&tag_ids=11)

  3. List phenotype by id

  4. Lists a phenotype by id for the user and the data sources associated with it.

    get /api/v1/phenotypes/{id}/
  5. List phenotype detail (latest version)

  6. Lists the phenotype detail of the latest version.

    get /api/v1/phenotypes/{id}/detail/
  7. List phenotype detail (of a specific version)

  8. Lists the phenotype detail of the specified version.

    get /api/v1/phenotypes/{id}/version/{version_id}/detail/
  9. Export the code list of a specific version of a phenotype

  10. Exports the code list of a specific version of a phenotype for the user.

    get /api/v1/phenotypes/{id}/version/{version_id}/export/codes/
  11. List the versions of a phenotype

  12. Lists all the versions of the phenotype for the user.

    get /api/v1/phenotypes/{id}/get-versions/
  13. Create/Update a phenotype

  14. Create a phenotype by passing a JSON object.

    post /api/v1/api_phenotype_create/

    Update a phenotype by passing a JSON object.

    put /api/v1/api_phenotype_update/

Data Sources:

  1. List data sources (with published phenotypes)

  2. Only the published associated phenotypes wil be shown.

    Lists all data sources and the published phenotypes associated with each. User can search by part of the data source name (e.g. ?search=hospital)

    get /api/v1/public/data-sources/

    Lists a data source by id and the associated published phenotypes.

    get /api/v1/public/data-sources/{id}

Authenticated APIs:

  1. List data sources

  2. Lists all data sources and the phenotypes associated with each. User can search by part of the data source name (e.g. ?search=hospital)

    get /api/v1/data-sources/

    Lists a data source by id and the associated phenotypes.

    get /api/v1/data-sources/{id}
  3. Create a data source

  4. Create a data source by passing a JSON object.

    post /api/v1/api_datasource_create/

Tags:

  1. List tags

  2. Lists all available tags.

    get /api/v1/tags/

    Lists tag by id.

    get /api/v1/tags/{id}