Quickstart

1. Obtener una API key

Crea una cuenta en fhiron.cl/registro. El plan Free incluye 1.000 validaciones por mes. Las herramientas del MCP que corren offline no consumen cuota.

2. Validar un recurso

El ejemplo de abajo envía un Encounter que el desarrollador armó copiando un payload de un EHR en inglés: usó "status": "complete" (intuición de inglés general) en vez del código del ValueSet EncounterStatus que exige FHIR R4. Es uno de los errores más frecuentes al migrar un HIS hacia FHIR.

curl -X POST https://fhiron.cl/api/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -d '{
    "resourceType": "Encounter",
    "status": "complete",
    "class": {
      "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
      "code": "AMB"
    },
    "subject": { "reference": "Patient/example" },
    "period": { "start": "2026-05-11T09:00:00-04:00" }
  }'

const response = await fetch("https://fhiron.cl/api/validate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.FHIRON_API_KEY,
  },
  body: JSON.stringify({
    resourceType: "Encounter",
    status: "complete",
    class: {
      system: "http://terminology.hl7.org/CodeSystem/v3-ActCode",
      code: "AMB",
    },
    subject: { reference: "Patient/example" },
    period: { start: "2026-05-11T09:00:00-04:00" },
  }),
});

const outcome = await response.json();

import os, requests

response = requests.post(
    "https://fhiron.cl/api/validate",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["FHIRON_API_KEY"],
    },
    json={
        "resourceType": "Encounter",
        "status": "complete",
        "class": {
            "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
            "code": "AMB",
        },
        "subject": {"reference": "Patient/example"},
        "period": {"start": "2026-05-11T09:00:00-04:00"},
    },
)
outcome = response.json()

La API responde 422 con el mismo ValidateResponse que usa para resultados válidos, incluyendo el issue cl-enc-04:

{
  "valid": false,
  "errors": [
    "Encounter.status='complete' no pertenece al ValueSet EncounterStatus."
  ],
  "warnings": [],
  "profile": null,
  "resourceType": "Encounter",
  "issues": [{
    "code": "cl-enc-04",
    "severity": "error",
    "path": "Encounter.status",
    "message": "Encounter.status='complete' no pertenece al ValueSet EncounterStatus.",
    "why": "FHIR R4 exige un código del ValueSet encounter-status.",
    "quickFix": {
      "title": "Cambiar status a finished",
      "jsonPointer": "/status",
      "replacement": "finished"
    }
  }]
}

issues[].quickFix lleva un parche RFC 6901 que fhiron_apply_fix o tu código pueden aplicar de forma idempotente.

3. Conectar el MCP al editor

npx -y @fhiron/mcp-connector init

El comando detecta el editor (Claude Desktop, Claude Code, Cursor, Windsurf, Antigravity), escribe la configuración con merge no destructivo y verifica el handshake. Más detalle en MCP: Instalación.

API reference

Endpoint, headers, rate limits.

Tools fhiron_*

Validación, lint, quickFix, búsqueda en catálogos.

Errores

Códigos cl-* con why, profileUrl y quickFix.

CL Core

Recursos cubiertos del IG.

Empezar

IA + MCP

Recetas

Inspect — Validación FHIR

CLI — Línea de comandos

SDK — Validación embebida

Insight — FHIR Score

Sandbox

Conceptos

Seguridad

Legal

1. Obtener una API key

2. Validar un recurso

3. Conectar el MCP al editor

Siguiente

API reference

Tools fhiron_*

Errores

CL Core

​1. Obtener una API key

​2. Validar un recurso

​3. Conectar el MCP al editor

​Siguiente

API reference

Tools fhiron_*

Errores

CL Core

1. Obtener una API key

2. Validar un recurso

3. Conectar el MCP al editor

Siguiente