Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

API für Symptomdaten: Konzepte, FHIR-Terminologie und vom Patienten berichtete Symptome

Stabile Symptom-Identifikatoren, zugeordnet zu ICD-10, bereitgestellt als REST und als FHIR CodeSystem, ValueSet und ConceptMap; wie ein vom Patienten berichtetes Symptom aussieht und wie man es validiert.

Anpheros gibt jedem Symptom eine stabile Kennung (SYM-0047 ist Kopfschmerz), ordnet es ICD-10 zu und stellt die Liste über einen REST-Endpunkt und als FHIR R4-Terminologie (CodeSystem, ValueSet, ConceptMap, $lookup) bereit. Vom Patienten berichtete Symptome werden als FHIR Observation gespeichert, die sowohl Codes, die eigenen Worte der Person, die Intensität und, wenn bekannt, den Beginn und das Ende des Symptoms enthalten. Diese Seite zeigt, wie man ein Konzept findet, wie ein vom Patienten berichtetes Symptom aussieht, wie man eines überprüft, das man selbst schreibt, und was die Daten bewusst nicht enthalten.

Was ist in der Version enthalten


Version	`2026.10.4` (jede Antwort gibt an, welche)
Konzepte	274: 197 Symptome (ICD-10 R00–R69 und ihre nicht-residualen Unterkategorien wie R06.0 Dyspnoe oder R43.0 Anosmie, plus der WHO-Code, wo die WHO das Symptom anders klassifiziert: G47, H53.2, H53.8, H93.1, K59.0, L29.9, M25.5, M54) und 77 Befunde (R65, R70–R94)
Identifikationssystem	`https://anpheros.com/fhir/CodeSystem/symptom`
Codes	geprüft gegen WHO ICD-10 Version 2019 (15. Oktober 2026) mit ihren Ein- und Ausschlussnotizen; WHO ICD-10 Titel werden nicht bereitgestellt, bis die WHO die Lizenz bestätigt (`icd10.display: null`), der offizielle englische Titel ist der ICD-11
ICD-11	jedes Konzept wird einem ICD-11 MMS 2025-01 Code (dem Kapitel 21 Symptomcode) und einem Körpersystem zugeordnet
Bereitgestellte Labels	der offizielle englische WHO ICD-11 Titel (`source`), die rumänischen Labels und übereinstimmenden Begriffe, die von Anpheros Daily verwendet werden (`in_use`), und Laien-Labels in 19 weiteren Sprachen (`ai_reviewed`: maschinelle Übersetzungen, die mit KI-Unterstützung überprüft wurden, nicht von einem professionellen medizinischen Übersetzer); für die 188 Konzepte, die in 2026.10.3 hinzugefügt wurden, ist der rumänische Name ebenfalls eine KI-Übersetzung
Klinische Überprüfung	`clinical_review: false` — kein Kliniker hat die Version überprüft; keine Ursachen oder Zustandsassoziationen
Warnhinweise	32, für 14 Konzepte, wörtlich zitiert von CDC und NIDDK Seiten (`review: source_quoted`)

Identifier werden niemals wiederverwendet. Ein zurückgezogenes Konzept bleibt mit status: deprecated in der Liste.

Konzept finden (REST)

export API=https://platform.anpheros.com/v1
export KEY=sk_test_…

curl "$API/terminology/symptoms?q=headache" -H "Authorization: Bearer $KEY"

q stimmt mit der Konzept-ID, den ICD-10- und ICD-11-Codes, den Labels und den Übereinstimmungstermen überein. Weitere Parameter: icd10=R51 (das Konzept für einen Code), icd11=MB4D, body_system=nervous, kind=symptom|finding|all, lang=de (die Sprache von display: das bevorzugte Label, andernfalls das Laien-Label, andernfalls Englisch), limit und offset.

{
  "data": [{
    "concept_id": "SYM-0047",
    "system": "https://anpheros.com/fhir/CodeSystem/symptom",
    "kind": "symptom",
    "status": "active",
    "display": "Headache, not elsewhere classified",
    "display_lang": "en",
    "icd10": {"system": "http://hl7.org/fhir/sid/icd-10", "code": "R51", "display": null, "equivalence": "equivalent"},
    "icd11": {"system": "http://id.who.int/icd/release/11/mms", "code": "MB4D", "display": "Headache, not elsewhere classified", "equivalence": "equivalent"},
    "body_system": {"code": "nervous", "display": "Symptoms, signs or clinical findings of the nervous system", "icd11_block": "BlockL1-MB4"},
    "labels": [
      {"lang": "ro", "use": "preferred", "text": "Durere de cap (cefalee)", "review": "in_use"},
      {"lang": "de", "use": "lay", "text": "Kopfschmerzen", "review": "ai_reviewed"}
    ],
    "match_terms": [{"lang": "ro", "text": "durere de cap"}, {"lang": "ro", "text": "cefalee"}],
    "clinical_review": false,
    "release": "2026.10.2"
  }],
  "total": 1,
  "release": "2026.10.2"
}

labels listet jedes bereitgestellte Label auf (20 Sprachen; hier gekürzt). Ein Konzept: GET $API/terminology/symptoms/SYM-0047.

Dieselbe Liste wie FHIR-Terminologie

export BASE=https://platform.anpheros.com/fhir/R4

curl "$BASE/CodeSystem/anpheros-symptom" -H "Authorization: Bearer $KEY"
curl "$BASE/CodeSystem/\$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro" -H "Authorization: Bearer $KEY"
curl "$BASE/ValueSet/\$expand?url=https://anpheros.com/fhir/ValueSet/anpheros-symptoms&filter=cough" -H "Authorization: Bearer $KEY"
curl "$BASE/ConceptMap/anpheros-symptom-to-icd10" -H "Authorization: Bearer $KEY"
curl "$BASE/ConceptMap/anpheros-symptom-to-icd11" -H "Authorization: Bearer $KEY"

CodeSystem/anpheros-symptom — content: complete, status: draft (die Version wurde nicht von einem Kliniker überprüft); Eigenschaften kind, status, icd10; rumänische Bezeichnungen, übereinstimmende Begriffe und Laienbezeichnungen als designation.
ValueSet/anpheros-symptoms — die aktiven Symptome (Befunde ausgeschlossen); $expand nimmt filter, displayLanguage, count und offset.
ConceptMap/anpheros-symptom-to-icd10 — equivalent oder wider, wenn der ICD-10-Code mehr als das Konzept abdeckt (H53.8 "Andere Sehstörungen" ist breiter als verschwommenes Sehen).
Alle sind schreibgeschützt und in den CapabilityStatement (GET $BASE/metadata) des Servers aufgeführt.

Ein vom Patienten berichtetes Symptom

So schreibt Anpheros Daily ein Symptom, das eine Person über sich selbst als vorhanden gemeldet hat:

{
  "resourceType": "Observation",
  "status": "final",
  "meta": {"profile": ["https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation"]},
  "category": [{"coding": [{"system": "urn:anpheros:observation-category", "code": "symptom"}]}],
  "code": {
    "text": "Mă doare capul de 3 zile",
    "coding": [
      {"system": "http://hl7.org/fhir/sid/icd-10", "code": "R51"},
      {"system": "https://anpheros.com/fhir/CodeSystem/symptom", "code": "SYM-0047", "display": "Headache"}
    ]
  },
  "subject": {"reference": "Patient/…"},
  "effectivePeriod": {"start": "2026-10-11T08:00:00+03:00", "end": "2026-10-14T18:00:00+03:00"},
  "valueQuantity": {"value": 6, "unit": "1-10", "system": "http://unitsofmeasure.org", "code": "{score}"}
}

code.text sind immer die eigenen Worte der Person, in ihrer Sprache (Observation.language); die Codes stehen daneben.
effectivePeriod wird verwendet, wenn die Person angibt, wann es begann oder endete; andernfalls ist effectiveDateTime der Zeitpunkt, an dem sie es notiert hat. Zeiten behalten den Offset des Telefons, das sie aufgezeichnet hat.
valueQuantity ist die Intensität auf einer Skala von 1–10; ohne diese gibt es keinen Wert.
Wenn die Person ein Symptom bearbeitet, erhält dieselbe Ressource eine neue Version – frühere Versionen liest man mit GET $BASE/Observation/{id}/_history.
Filtern Sie nach Kategorie mit ?category=symptom; Zustimmungsbereiche wie patient/Observation.rs?category=symptom funktionieren auf die gleiche Weise.

Was niemals als Symptom veröffentlicht wird

Nur Symptome, die vorhanden und über den Patienten sind, werden zu Observations, und das erst, nachdem der Freitext normalisiert wurde. "Mein Kopf tut nicht mehr weh", "vielleicht morgen Fieber", "meine Mutter hat Husten" oder ein Text, den der Normalisierer nicht lesen konnte, werden nicht zum Symptom eines Patienten; wenn ein veröffentlichtes Symptom später in eines dieser korrigiert wird, wird seine Observation zurückgezogen (Soft Delete – die Historie bleibt erhalten). Beschwerden von Verwandten werden nicht automatisch in die Familiengeschichte übernommen.

Symptom prüfen, das Sie schreiben

curl -X POST "$BASE/Observation/\$validate?profile=anpheros-symptom" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/fhir+json" -d @symptom.json

Das anpheros-symptom-Profil (kanonisch https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation) berichtet als OperationOutcome:

Regel	Schweregrad
Kategorie `urn:anpheros:observation-category\\|symptom` (das HL7 `observation-category`-System hat keinen `symptom`-Code)	error
`code.text` vorhanden	error
Ein Anpheros-Konzept, das existiert und dem ICD-10-Code entspricht	error
`subject` ist ein Patient; `status` final, amended, corrected oder entered-in-error; `effective[x]` vorhanden; `effectivePeriod.end` nicht vor `start`	error
Intensität als UCUM `{score}` zwischen 0 und 10	error
Nur Freitext, keine Codes	information (still valid)

Wie die anderen Profile berichtet es und lehnt Schreibvorgänge nicht ab. Ein meta.profile, den Sie senden, wird in der gespeicherten Ressource beibehalten.

Einschränkungen

Die Version wurde nicht von einem Kliniker überprüft; verwenden Sie sie für Codierungs- und Suchzwecke, nicht für medizinische Entscheidungen.
Warnhinweise werden wörtlich aus öffentlich zugänglichen US-Bundesseiten (CDC: Schlaganfall- und Herzinfarktanzeichen; NIDDK: Durchfall und Verstopfung) zitiert und wurden am 15. Oktober 2026 mit diesen Seiten abgeglichen. Jeder Eintrag enthält die eigene Überschrift der Quelle (context), ihren Rat (quote), die Gruppe, für die er gilt (applies_to), die Quelle mit Lizenz und Quellenangabe (review: source_verified) sowie den Hinweis, dass es sich nicht um eine Diagnose handelt und nicht von einem Kliniker überprüft wurde. Die Quellen sind amerikanisch: Wo ein Zitat 9-1-1 lautet, wird der Hinweis hinzugefügt, dass die Notrufnummer in Europa 112 ist.
Es werden keine Ursachen oder Zustandsassoziationen bereitgestellt: associations bleibt leer, bis ein Kliniker einen Eintrag überprüft hat. Eine Assoziation lautet immer "kann assoziiert sein mit".
SNOMED CT-Codes werden nur dort geschrieben, wo die Lizenz dies zulässt (siehe FHIR-Codesysteme).
Frühere Symptom-Beobachtungen erhalten beim nächsten Update die Anpheros-Konzeptcodierung.