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

API de dados de sintomas: conceitos, terminologia FHIR e sintomas reportados pelo paciente

Identificadores de sintomas estáveis mapeados para ICD-10, servidos como REST e como FHIR CodeSystem, ValueSet e ConceptMap; como se parece uma Observação de sintoma reportada pelo paciente e como validar uma.

A Anpheros atribui a cada sintoma um identificador estável (SYM-0047 é dor de cabeça), mapeia-o para ICD-10 e disponibiliza a lista através de um endpoint REST e como terminologia FHIR R4 (CodeSystem, ValueSet, ConceptMap, $lookup). Os sintomas que os pacientes relatam são armazenados como Observations FHIR que contêm ambos os códigos, as palavras próprias da pessoa, a intensidade e, quando conhecidos, quando o sintoma começou e terminou. Esta página mostra como encontrar um conceito, como é um sintoma relatado pelo paciente, como verificar um que você escreve, e o que os dados deliberadamente não contêm.

O que está na versão

Os identificadores nunca são reutilizados. Um conceito que é retirado permanece na lista com status: deprecated.

Encontrar um conceito (REST)

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

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

q corresponde ao ID do conceito, aos códigos ICD-10 e ICD-11, aos rótulos e aos termos de correspondência. Outros parâmetros: icd10=R51 (o conceito para um código), icd11=MB4D, body_system=nervous, kind=symptom|finding|all, lang=de (o idioma de display: o rótulo preferido, caso contrário o rótulo leigo, caso contrário inglês), limit e 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 lista todos os rótulos servidos (20 idiomas; encurtados aqui). Um conceito: GET $API/terminology/symptoms/SYM-0047.

A mesma lista que a terminologia FHIR

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 (a versão não foi revista por um clínico); propriedades kind, status, icd10; rótulos romenos, termos correspondentes e rótulos leigos como designation.
• ValueSet/anpheros-symptoms — os sintomas ativos (achados excluídos); $expand utiliza filter, displayLanguage, count e offset.
• ConceptMap/anpheros-symptom-to-icd10 — equivalent, ou wider quando o código ICD-10 abrange mais do que o conceito (H53.8 "Outras perturbações visuais" é mais abrangente do que visão turva).
• Todos eles são somente leitura e listados no CapabilityStatement do servidor (GET $BASE/metadata).

Um sintoma reportado pelo paciente

É assim que o Anpheros Daily regista um sintoma que uma pessoa reportou como presente, sobre si mesma:

{
  "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 são sempre as palavras da própria pessoa, na sua língua (Observation.language); os códigos ficam ao lado.
• effectivePeriod é usado quando a pessoa disse quando começou ou terminou; caso contrário, effectiveDateTime é o momento em que o registou. As horas mantêm o offset do telefone que as gravou.
• valueQuantity é a intensidade numa escala de 1 a 10; sem ela não há valor.
• Quando a pessoa edita um sintoma, o mesmo recurso recebe uma nova versão — leia as anteriores com GET $BASE/Observation/{id}/_history.
• Filtre por categoria com ?category=symptom; os âmbitos de consentimento, como patient/Observation.rs?category=symptom, funcionam da mesma forma.

O que nunca é publicado como sintoma

Apenas os sintomas que estão presentes e sobre o paciente se tornam Observações, e apenas após o texto livre ter sido normalizado. "A minha cabeça já não dói", "talvez febre amanhã", "a minha mãe tem tosse" ou um texto que o normalizador não conseguiu ler não se tornam um sintoma do paciente; se um sintoma publicado for posteriormente corrigido para um destes, a sua Observação é retirada (eliminação lógica — o histórico permanece). As queixas de familiares não são automaticamente transformadas em histórico familiar.

Verifique um sintoma que escreve

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

O perfil anpheros-symptom (canónico https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation) reporta, como um OperationOutcome:

Tal como os outros perfis, reporta e não rejeita escritas. Um meta.profile que envia é mantido no recurso armazenado.

Limites

• A versão não foi revista por um clínico; utilize-a para codificação e pesquisa, não para decisões médicas.
• Os sinais de alerta são citados palavra por palavra de páginas federais de domínio público dos EUA (CDC: sinais de AVC e ataque cardíaco; NIDDK: diarreia e obstipação) e foram verificados contra essas páginas em 15 de outubro de 2026. Cada item inclui o próprio cabeçalho da fonte (context), o seu conselho (quote), o grupo a que se aplica (applies_to), a fonte com licença e atribuição, review: source_verified e a nota de que não se trata de um diagnóstico e não foi revisto por um clínico. As fontes são americanas: onde uma citação diz 9-1-1, a nota acrescenta que o número de emergência na Europa é 112.
• Não são apresentadas causas nem associações de condições: associations permanece vazio até que um clínico revise um item. Uma associação é sempre "pode estar associada a".
• Os códigos SNOMED CT são escritos apenas onde a licença o permite (ver Sistemas de código FHIR).
• As Observações de sintomas anteriores recebem a codificação de conceito Anpheros na próxima vez que forem atualizadas.

Relacionado

• Anpheros Symptom Engine: metodologia: como os conceitos são atribuídos, verificados e avaliados
• Anpheros Search: uma pesquisa sobre sintomas, condições e tratamentos, com fontes
• FHIR code systems: todos os sistemas de código por tipo de recurso
• API de dados longitudinais do paciente
• Como armazenar registos médicos usando FHIR R4
• Plataforma FHIR

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