redix-client

Python client for Redix Universal Healthcare Conversion API.

Version: 2.1.1 Repository: PyPI

Install

pip install redix-client

Quick Start

from redix_client import RedixClient

# Initialize client
client = RedixClient(
    base_url="https://demo.redix.com",
    api_key="YOUR_API_KEY"
)

# Health check
response = client.get("/")
print(response)  # {'status': 'healthy', 'version': '2.1.1'}

# List staging files
files = client.get("/api/v2/staging-files")
print(files)

# Upload a file to staging
result = client.post("/api/v2/staging/upload", files={
    "file": "/path/to/input.txt"
})

# Convert HL7 to FHIR
result = client.post("/api/v2/convert/hl7-to-fhir", files={
    "file": "/path/to/message.hl7"
})

API Methods

The client provides simple HTTP methods that work with any API endpoint:

Examples

File Conversion (v1 API - Redix Engine)

# Convert with file upload
result = client.post("/api/v2/convert/file-upload",
    files={
        "Input_File": "/path/to/input.txt",
        "IFD_File": "/path/to/rules/835.ifd",
        "OFD_File": "/path/to/rules/835.ofd"
    },
    data={
        "Conversion_Flag": "e - UN/EDIFACT/RMap",
        "WarningLevel": 1,
        "User_Data": "0*\\**:*?"
    }
)

# View output file
output = client.get(f"/api/v2/view-file/output/{result['filename_base']}.out")
print(output['content'])

FHIR Conversions (v2 API)

# HL7 to FHIR
result = client.post("/api/v2/convert/hl7-to-fhir", files={
    "file": "/path/to/message.hl7"
})

# CDA to FHIR
result = client.post("/api/v2/convert/cda-to-fhir", files={
    "file": "/path/to/document.xml"
})

# HIPAA X12 to FHIR
result = client.post("/api/v2/convert/hipaa-to-fhir", files={
    "file": "/path/to/835.x12"
})

# Smart convert (auto-detect format)
result = client.post("/api/v2/convert/smart", files={
    "file": "/path/to/unknown_format.dat"
})

Batch Processing

# Start batch conversion
job = client.post("/api/v2/batch-convert/folder", data={
    "Input_Subfolder": "incoming",
    "Config_Profile": "835_to_rmap"
})
job_id = job["Job_Id"]

# Check status
status = client.get(f"/api/v2/batch-status/{job_id}")
print(status)

# List all batch jobs
jobs = client.get("/api/v2/batch-jobs", params={"Limit": 10})

File Operations

# Upload to staging
client.post("/api/v2/staging/upload", files={"file": "data.txt"})

# List staging files
files = client.get("/api/v2/staging-files")

# Delete from staging
client.delete("/api/v2/staging/myfile.txt")

# Download converted file
client.download("/api/v2/download-file/output/result.out", "./downloads/")

Admin Operations (v2 API)

# List users
users = client.get("/api/v2/admin/users")

# Create user
client.post("/api/v2/admin/users", json={
    "username": "newuser",
    "password": "secure123",
    "role": "user"
})

# Get statistics
stats = client.get("/api/v2/statistics")

# Get conversion history
history = client.get("/api/v2/history", params={"limit": 50})

Configuration

Environment Variables

export REDIX_API_URL=https://demo.redix.com
export REDIX_API_KEY=your-api-key

Then initialize without parameters:

client = RedixClient()

SSL Verification

For self-signed certificates in development:

client = RedixClient(
    base_url="https://localhost:8080",
    api_key="your-key",
    verify_ssl=False
)

Error Handling

from redix_client import RedixClient, RedixAPIError

client = RedixClient(base_url="https://demo.redix.com", api_key="your-key")

try:
    result = client.get("/api/v2/batch-status/invalid_id")
except RedixAPIError as e:
    print(f"Error {e.status_code}: {e.message}")

Documentation

• Interactive API Documentation - Swagger UI
• API Reference - ReDoc

License

MIT - Redix International, Inc.