OnyeOne Documentation
  1. Guides
OnyeOne Documentation
  • Overview
  • OnyeOne Use Cases
  • Authentication
  • Guides
    • OnyeOne Request Flow
  • Core EHR/EMR FHIR R4 APIs
    • Administration
      • Patients
        • Create Patient Resource
        • Update Patient Resource
      • Practitioners
        • Create Practitioner Resource
        • Update Practitioner Resource
        • Create Practitioner Role
        • Update PractitionerRole Resource
      • Locations
        • Create a Location Resource
        • Update Location Resource
      • Health Service
        • Create Health Service Resource
        • Update Health Service Resource
      • Encounters
        • Create Encounter Resource
        • Update Encounter Resource
      • Appointments
        • Create Appointment Resource
        • Update Appointment Resource
      • Group
    • Clinical
      • AllergyIntolerance
      • Condition (Problem)
      • Procedure
      • FamilyMemberHistory
      • CarePlan
      • Goal
      • CareTeam
      • ClinicalImpression
      • AdverseEvent
      • DetectedIssue
      • RiskAssessment
    • Diagnostics
      • Observation
        • Create Observation Resource
      • DiagnosticReport
      • ServiceRequest
      • Media
      • ImagingStudy
      • MolecularSequence
      • Specimen
      • BodyStructure
    • Medications
      • MedicationRequest
      • MedicationDispense
      • MedicationAdministration
      • MedicationStatement
      • Medication
      • MedicationKnowledge
      • Immunization
      • ImmunizationEvaluation
      • ImmunizationRecommendation
    • Financial
      • Account
      • Contract
      • Coverage
      • CoverageEligibilityRequest
      • CoverageEligibilityResponse
      • EnrollmentRequest
      • EnrollmentResponse
      • Claim
      • ClaimResponse
      • PaymentNotice
      • PaymentReconciliation
      • ExplanationOfBenefit
      • VisionPrescription
  • Health Data Transformation
    • Transfrom HL7v2 to FHIR R4
      POST
    • Transform CCDA to FHIR R4
      POST
    • Transform HL7v2 to FHIR R4 and Store in Backend Database
      POST
    • Track API Request
      GET
  • Health Interoperabilty System
    • Create a Subscription
      POST
  • Webhook
  • Get Resource.
    GET
  1. Guides

OnyeOne Request Flow

The following document describes the overall architectural workflow of OnyeOne's platform, focusing on how requests are routed and processed based on specific headers and provider configurations.

Overview#

OnyeOne's platform is designed to handle API requests dynamically based on the x-backend-id and x-api-key headers provided in each request. The architecture allows providers to either:
1.
Use a custom backend they maintain.
2.
Leverage the platform's managed backend.

Workflow Diagram#

Below is a high-level description of how requests are handled:

Key Benefits of the Architecture#

Flexibility: Allows providers to bring their own backends or use the managed backend.
Scalability: Efficiently routes requests to appropriate backends without bottlenecks.
Security: Ensures only authorized API users can access resources using x-api-key validation.

Example Scenarios#

Scenario 1: Request with x-backend-id#

Scenario 2: Request without x-backend-id#

Scenario 3: Invalid API Key#

Previous
Authentication
Next
Core EHR/EMR FHIR R4 APIs
Built with