HealthTags API – Index

This folder contains everything you need to call — and experiment with — the three complementary REST/JSON helpers that sit behind Health Tags.

Use the management pages when integrating with your own tools. They provide simple forms for searching tags and SNOMED concepts while also showing the underlying API requests. If you only want to explore the endpoints, the API test pages offer quick harnesses for manual experimentation.

File	What it is
`Tags_Readme.md`	Full guide for the Tags Service (Concept → Tags & tag lookups)
`TagSearch_Readme.md`	Guide for the Tags Service search endpoint
`SnoMed_Readme.md`	Full guide for the SnoMed Service (Tag → Concepts & concept lookups)
`Readme.md`	This overview document

Management pages

tag-search.html – search tags via the Tags Service
concept-search.html – search SNOMED concepts

API test pages

Tags.html – query tags by Concept ID or Term
SnoMed.html – query concepts by Tag ID or Name

1 · Service cheat-sheet

Input you have	Call this service	Docs
Tag Name `"Antifungal medicines"`	SnoMed Service (concepts ⇐ tag)	`SnoMed_Readme.md`
Tag ID `65`	SnoMed Service
Concept ID `409794001`	Tags Service (tags ⇐ concept)	`Tags_Readme.md`
Concept Term `"Antifungal agent resistant fungi"`	Tags Service
Tag Search Term `"Antifungal"`	Tags Service (search)	`TagSearch_Readme.md`

Both endpoints are read-only and stateless; a single query-string parameter or JSON payload is all that’s required.

2 · Runtime conventions

Public host https://healthtags.buffa.ly (Dev and staging hosts may differ.)
Authentication Optional header AuthToken: <jwt | opaque string>
JavaScript runtime Load the generated JsonWS proxies alongside the platform JsonMethod.js bootstrap (served from //static.buffa.ly/js/JsonMethod.js?v=2 in these samples) to call the services without manual fetch plumbing.

<!-- JsonWS bootstrap + generated proxies -->
<script src="//static.buffa.ly/js/JsonMethod.js?v=2"></script>
<script src="/JsonWS/HealthTags.TagsService.ashx.js"></script>
<script src="/JsonWS/HealthTags.SnoMedService.ashx.js"></script>

<!-- Page-specific helpers -->
<script src="/projects/HealthTags/TagSearch.js"></script>
<script src="/projects/HealthTags/conceptsearch.js"></script>

3 · Quick demos

Open the harness pages in your browser:

Tags.html Query tags by Concept ID or Term
SnoMed.html Query concepts by Tag ID or Name
concept-search.html Search SNOMED concepts

No build step required—just drop them under the site root.

4 · Learn more

Tags Service see Tags_Readme.md
SnoMed Service see SnoMed_Readme.md

Those files include SDK usage, raw fetch/curl examples, and request/response payloads.

Sample JSON Entry

{
  "IsBroadParentTag": "false",
  "TagID": "65",
  "TagName": "Antifungal medicines",
  "Alternates": ["Antifungal agent", "Antifungal drug"],
  "Concepts": [
    {
      "ConceptID": "409794001",
      "IsDisorder": "false",
      "PreferredTerm": "Antifungal agent resistant fungi"
    },
    {
      "ConceptID": "773126007",
      "IsDisorder": "false",
      "PreferredTerm": "Application of topical antifungal agent to skin"
    },
    {
      "ConceptID": "292800009",
      "IsDisorder": "false",
      "PreferredTerm": "Antifungal drug adverse reaction"
    },
    {
      "ConceptID": "410575005",
      "IsDisorder": "false",
      "PreferredTerm": "Intravitreal antifungal drug injection"
    }
  ]
}

TagID (65) – unique identifier for the tag.
TagName – primary label defined in the HealthTags database.
IsBroadParentTag – flag carried over from the database.
Alternates – alternative names that expand matching.
Concepts – SNOMED CT concepts related to the tag.