Welcome

Documentation for the Stitch.js javascript library, containing a [WebComponent](https://www.webcomponents.org/introduction) for building Fasten Connect applications.

Introduction

Fasten Connect

Authentication

This endpoint will generate a state value and redirect the user to their healthcare provider Patient Portal to authenticate with the healthcare provider's EHR.

On completion, Fasten Connect will redirect the user back to your redirect_uri with an `org_connection_id` and `endpoint_id` query parameter.

If an error occurred during the authentication process, Fasten Connect will redirect the user back with an `error` and `error_description` query parameter.

<Warning>
This is done automatically by the [Stitch.js](stitch/introduction) widget.
</Warning>


Initiate Connection

<Note>
This endpoint is idempotent. If a request with the same `org_connection_id` has already been registered, it will return the existing request.
</Note>

This endpoint will register an bulk medical record export request with the Fasten Connect API for the provided `org_connection_id` (Patient id)

This functionality is similar in design to the HL7 [EHI Export](https://build.fhir.org/ig/argonautproject/ehi-api/ehi-export.html) specification.
However it is designed to be a unified API for all EHRs, as many EHRs do not support the HL7 EHI Export specification.

<Warning>
This endpoint requires an API public id & private key for authentication. Do not expose these keys in the browser.
</Warning>

This task will run asynchronously and may take some time to complete. 
You can check the status of the task using the [Get Request Status](/api-reference/ehi_export/get) endpoint.

On completion a webhook will be sent to your `webhook_url` with metadata about the task, and a `download_link` to download the results.


Bulk Records Request

Check the status of the EHI Export Task. If the task completed successfully, it will return a download link to download the results.

A webhook will also be sent to your `webhook_url` with metadata about the task, which is the preferred method to receive task results.

<Warning>
This endpoint requires an API public id & private key for authentication. Do not expose these keys in the browser.
</Warning>


Get Request Status

When provided with a `taskId` and `fileId`, this endpoint will return a signed URL to download the file in the `Location` header.
Your http client should be able to follow the redirect and download the file.

This signed URL will expire after a short period of time, so you should download the file immediately.
If you are unable to do so, you can request a new signed URL by calling this endpoint again.

<Warning>
This endpoint requires an API public id & private key for authentication. Do not expose these keys in the browser.
</Warning>


Download Bulk Records

Get information about your organization. This is used to display branding information in the Stitch.js popup widget.

Get Organization

Check the status of an existing organization connection.
        
<Warning>
This endpoint requires an API public id & private key for authentication. Do not expose these keys in the browser.
</Warning>


Get Organization Connection

Search for healthcare institutions supported by Fasten Connect. 

<Note>
This is used to display branding information in the Stitch.js popup widget.
This API not required, unless you are building a custom widget.
</Note>

<Warning>
This API is rate limited and is subject to change. **Please contact support@fastenhealth.com before use.**
</Warning>

Search Catalog Brands

Get branding & metadata information associated with healthcare institutions supported by Fasten Connect. 

<Note>
This is used to display branding information in the Stitch.js popup widget.
This API not required, unless you are building a custom widget.
</Note>

Get Catalog Entry

<fasten-stitch> is a custom element that injects our healthcare institution selector.

Quick Start

The stitch Web Component has multiple options that can be used to customize the look and feel of the component.

Web Component

Use Webhooks to listen to events from Fasten Connect, rather than polling the API.

There are multiple event types that can be emitted by Fasten Connect.

Event Types

This section helps you understand different behaviors of Fasten Connect webhook delivery & provides some best practices.

Delivery

Verify webhook signatures to confirm that received events are sent from Fasten Connect

Stitch

​Welcome

Welcome