HL7 to JSON Converter

Instantly convert raw HL7 v2 messages into structured JSON. Automatically extract embedded Base64 attachments (PDFs, images, clinical documents) to secure, temporary S3 download URLs.

原始信息汇总

数据集概述：HL7 to JSON Converter

一、基本信息

• API名称: HL7 to JSON Converter
• 提供商: HealthTech Integrations
• 分类: Medical
• 订阅用户数: 1
• 定价方案:
  • BASIC: $0.00/月
  • PRO: $39.00/月
  • ULTRA: $99.00/月
• 性能指标:
  • 流行度: 8.8
  • 服务等级: 100%
  • 延迟: 1779ms
  • 测试通过率: 100%

二、核心功能

1. HL7 v2 消息转换为 JSON: 将原始 HL7 v2 消息解析为结构化的 JSON 格式，支持标准分隔符集（| 字段分隔符、^ 组件分隔符）。
2. 通用附件提取: 自动检测 OBX 段中的封装数据（ED）和 Base64 编码负载（如 PDF、JPEG/PNG、Word 文档），解码后生成安全的临时 S3 下载链接。
3. 智能段映射: 完美处理 MSH、PID、ORC、OBR、OBX和NTE` 段，兼容非标准换行符和供应商特定的格式问题。
4. 即时 ACK 生成: 自动返回标准的 HL7 确认（ACK）字符串，可用于发回发送方系统。

三、支持解析的段

段	内容
MSH	消息类型、控制 ID
SFT	发送软件/供应商信息
PID	患者人口统计信息
PV1 + PV2	就诊详情（类别、位置、主治医生、入院原因）
ORC + OBR	订单控制和订单/请求详情
TQ1	订单的时间/数量
SPM	标本详情（类型、采集日期）
OBX	观察结果
NTE	注释/评论，正确关联到患者、订单或特定结果

• 未列出的段不会被丢弃，会返回到 otherSegments 字段中。

四、隐私与合规

• 零持久存储: 患者健康信息（PHI）仅在内存中处理，生成 JSON 响应后立即丢弃。
• 临时文件托管: 提取的临床附件存储在加密的 S3 存储桶中，遵循严格的生命周期规则，提取后约 1 小时内自动永久删除。
• 下载链接有效期: 生成后 15 分钟过期，无法重新生成已清除文件的链接。

五、接口信息

• 端点: POST https://hl7-to-json-converter.p.rapidapi.com/api/v1/convert
• 请求头: Content-Type: text/plain，需要包含 X-RapidAPI-Key 和 X-RapidAPI-Host。
• 请求体: 原始 HL7 v2 消息文本。
• 响应状态码:
  • 200: 消息已处理，返回 data（结构化 JSON）和 ack（确认字符串）。
  • 401: 缺少或无效的身份验证。
  • 422: 请求体为空。
  • 500: 处理消息时发生意外错误。

六、响应结构示例

• 无附件情况下，每个观测值（observations[]）的 fileUrl 和 fileType 为 null。
• 有附件情况下，对应观测值的 value 将被替换为 fileUrl 和 fileType。