Introduction

Async integration microservice for HL7 v2.x and canonical models

integration-service builds HL7 v2.x messages, generates canonical Pydantic models, applies rule templates, and delivers messages over HTTP or TCP/IP.

Authentication

Every /api/* endpoint requires a shared-secret bearer token:

Authorization: Bearer <token>

Requests without a valid token are rejected with 401. Health and metrics endpoints (/health, /health/live, /health/ready, /metrics) are public.

Base URL

https://us-integrations.crelio.solutions

API Reference

See the API Reference section for every endpoint, its request/response schema, and example payloads. This reference is generated from the service’s OpenAPI schema, so it always matches the deployed code.