HealthTags API – Index

This folder contains everything you need to call — and experiment with — the two complementary REST/JSON services 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 Tag Mapping Service (Concept → Tags)
`TagSearch_Readme.md`	Guide for the Tags Service search endpoint
`SnoMed_Readme.md`	Full guide for the SnoMed Mapping Service (Tag → Concepts)
`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 Mapping Service (concepts ⇐ tag)	`SnoMed_Readme.md`
Tag ID `65`	SnoMed Mapping Service
Concept ID `409794001`	Tag Mapping Service (tags ⇐ concept)	`Tags_Readme.md`
Concept Term `"Antifungal agent resistant fungi"`	Tag Mapping Service
Tag Search Term `"Antifungal"`	Tags Service (search)	`TagSearch_Readme.md`

Both endpoints are read-only and stateless; a single query-string parameter 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 Both generated proxies depend on https://static.buffa.ly/js/JsonMethod.js

<script src="https://static.buffa.ly/js/JsonMethod.js"></script>

<!-- Tag service -->
<script src="/JsonWs/HealthTags.TagMappingService.ashx.js"></script>

<!-- SnoMed service -->
<script src="/JsonWs/HealthTags.SnoMedMappingService.ashx.js"></script>

Client-side validation overrides Override the default field validators by defining TagMappingServiceValidatorsFields or SnoMedMappingServiceValidatorsFields before loading the proxy file.

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

Tag Mapping Service see Tags_Readme.md
SnoMed Mapping Service see SnoMed_Readme.md

Those files include SDK usage, raw fetch/curl examples, error-handling guidelines, and validator extension points.

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.