Skip to main content

Integration Setup

Set up Oneliac integrations with external systems.

API Authentication​

API Keys​

Generate API keys for authentication:

curl -X POST http://localhost:8000/auth/keys \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Response:

{
  "api_key": "sk_live_abc123...",
  "created_at": "2025-01-01T00:00:00Z"
}

Using API Keys​

curl http://localhost:8000/api/v1/eligibility \
  -H "Authorization: Bearer sk_live_abc123..."

Webhook Configuration​

Register Webhooks​

curl -X POST http://localhost:8000/webhooks \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-system.com/webhooks/oneliac",
    "events": ["eligibility.verified", "prescription.validated"]
  }'

Event Payload​

{
  "event": "eligibility.verified",
  "timestamp": "2025-01-01T00:00:00Z",
  "data": {
    "patient_id": "hash_abc123",
    "coverage_percentage": 85,
    "requires_auth": false
  }
}

External System Integration​

EHR Systems​

Integrate with Electronic Health Records:

from oneliac.integrations import EHRConnector

ehr = EHRConnector(
    endpoint="https://ehr.hospital.com/api",
    api_key="your-api-key"
)

patient_data = ehr.get_patient(patient_id)

Insurance APIs​

Connect to insurance verification systems:

from oneliac.integrations import InsuranceVerifier

verifier = InsuranceVerifier(
    provider="aetna",
    credentials=credentials
)

coverage = verifier.check_coverage(member_id)

Pharmacy Systems​

Integrate with pharmacy networks:

from oneliac.integrations import PharmacyNetwork

pharmacy = PharmacyNetwork(
    network="ncpa",
    api_key="your-api-key"
)

availability = pharmacy.check_availability(ndc_code)

Rate Limiting​

API rate limits:

  • Authenticated: 1000 requests/minute
  • Public: 10 requests/minute

Headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640888000

Error Handling​

Handle API errors gracefully:

try:
    result = client.verify_eligibility(patient_id)
except OneliacError as e:
    logger.error(f"Verification failed: {e.code} - {e.message}")

Testing Integration​

Use the sandbox environment:

SOLANA_RPC_URL=https://api.devnet.solana.com
ENVIRONMENT=sandbox