5 min · Empezar a validar
Quickstart
Bridge es la API de validación de Fhiron. Recibe un recurso FHIR R4 y lo valida contra los perfiles oficiales de CL Core v1.9.3, devolviendo errores en español con referencia exacta al perfil que falla.
Sin persistencia de datos clínicos: validamos y no guardamos copia del recurso. Solo metadatos de uso (cuántas validaciones hiciste, no el contenido).
- Crea cuenta en fhiron.cl/registro (sin tarjeta).
- Copia tu API Key del Dashboard.
- Envía un POST a /api/validate con el recurso en el body.
X-API-Key header
Autenticación
Cada request necesita tu API Key en el header X-API-Key. Se obtiene desde el Dashboard tras crear cuenta.
Cómo obtener tu API Key
- Ingresa al Dashboard → Ajustes
- Sección "API Keys" del panel lateral
- Copia y guárdala — no se muestra dos veces
POST · application/json
Endpoint /api/validate
https://fhiron.cl/api/validateHeaders requeridos
| Content-Type | application/json |
| X-API-Key | Tu API Key (UUID) |
Body
Un recurso FHIR R4 completo en JSON. Debe incluir resourceType. Opcionalmente meta.profile para forzar validación contra un perfil específico.
curl · request → response
Ejemplo de uso
Validar un Patient con RUN contra el perfil CorePacienteCl:
curl -X POST https://fhiron.cl/api/validate \
-H "Content-Type: application/json" \
-H "X-API-Key: TU_API_KEY" \
-d '{
"resourceType": "Patient",
"meta": {
"profile": [
"https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/CorePacienteCl"
]
},
"identifier": [{
"use": "official",
"type": {
"coding": [{
"system": "https://hl7chile.cl/fhir/ig/clcore/CodeSystem/CSIdentificadores",
"code": "01"
}]
},
"value": "15420097-3"
}],
"name": [{ "use": "official", "family": "González", "given": ["Ana"] }],
"gender": "female",
"birthDate": "1985-07-14"
}'Si el recurso es válido, recibes 200:
{
"valid": true,
"errors": [],
"warnings": [],
"profile": "CorePacienteCl",
"resourceType": "Patient"
}Si tiene errores, recibes 422 con los errores en español:
{
"valid": false,
"errors": [
"El campo Patient.identifier[0].value no cumple el formato requerido por el perfil RUNcl.",
"El campo Patient.name es obligatorio según el perfil CorePacienteCl."
],
"warnings": [],
"profile": "CorePacienteCl",
"resourceType": "Patient"
}Errores y significado
Códigos HTTP
| Código | Significado | Cuándo ocurre |
|---|---|---|
| 200 | Recurso válido | El recurso FHIR cumple con CL Core v1.9.3 |
| 400 | Request inválido | JSON malformado o falta resourceType |
| 401 | No autenticado | Falta el header X-API-Key |
| 403 | API Key inválida | La API Key no existe o el tenant está inactivo |
| 422 | Recurso inválido | El recurso no cumple CL Core — errores en el body |
| 429 | Límite alcanzado | Superaste las validaciones de tu plan este mes |
| 502 | Motor no disponible | El motor de validación no responde (temporal) |
Claude · Cursor · Continue
Servidor MCP
Fhiron expone un servidor Model Context Protocol que cualquier asistente IA compatible puede consumir para validar FHIR contra CL Core desde el chat — sin glue code.
El tool se llama fhiron_validate, recibe el recurso JSON y devuelve el mismo payload que la API REST (validación + errores en español).
Setup en Claude Desktop
Agrega Fhiron como MCP server en claude_desktop_config.json:
{
"mcpServers": {
"fhiron": {
"command": "npx",
"args": ["-y", "@fhiron/mcp"],
"env": { "FHIRON_API_KEY": "tu_api_key" }
}
}
}