Developer information

Physitrack integrates with many Practice Management Systems to offer practitioners time-savings and data integrity between solutions.

If you have a practice management system / EHR, we'll be happy to assist you in adding an integration between Physitrack and your platform. Read on below.

Integration types

Most of the practice management systems that integrate with Physitrack use (a combination of the) integration types listed below.

  1. Single sign on (SSO) & copy patient from your system to Physitrack
  2. Webhook to download PDF version of assigned (or updated) program from Physitrack to your system
  3. Physitrack RESTful API write: access Physitrack functionality from your UI (e.g. assign a template to a patient).
  4. Physitrack RESTful API read: add webhooks to listen to our events and automatically collect patient outcomes data such as adherence, PROM scores and messages.
  5. iframe integration of Physitrack into your system's user interface.

Documentation

Getting started

  1. Decide on the type of integration you'd like to set up
  2. Email support@physitrack.com so we can set you up on our staging environment
  3. Develop & test your integration
  4. Write clear step by step documentation for your users. Include screenshots.
  5. Email us when you've completed your integration. Include information for us to login to your system and test the integration from our end.

Note:

  • We usually only accept integrations with commercial patient management systems / EHRs that have at least 500 practitioners.
    We make exceptions for larger practices (50+ practitioners who subscribe to Physitrack) who have in-house patient management systems.
  • Depending on the commercial relationship between your system and Physitrack, we may ask you to sign an API Usage Agreement before granting you access to our API.

1. Single Sign On (SSO)

This is our most basic type of integration. Robust, easy to implement and very convenient for the practitioner: the practitioner logs in to Physitrack and adds/opens the client with one click.
The RESTful integration (3 & 4) builds on the SSO integration.

Authentication is through a shared secret (your system generates a token which is added to the practitioner's account in Physitrack). We also support OAuth, with your system being the OAuth provider.

  • The practitioner clicks a UI control in your UI (e.g. "Open client in Physitrack").
  • This then triggers an HTTP POST request from your system to Physitrack with the required data.
  • Physitrack then returns a 302 to the practitioner's browser, redirecting them to the client.

SSO documentation

2. Get a PDF of the assigned/updated program

This feature builds on the SSO integration listed above. It allows for improved compliance and record keeping in your system and is a much loved feature by practitioners worldwide.

  • Physitrack registers your https endpoint and a secret token that you use to authenticate requests that we send to you.
  • When a practitioner assigns or updates an exercise program, Physitrack calls your endpoint and you can download a PDF version of the exercise program for storage in your system.

PDF documentation

3. & 4. Physitrack's RESTful API

If you'd like to enrich your system with core Physitrack functionality, such as assigning templates to patients, or if you'd like to automatically get patient adherence data from Physitrack into your system, Physitrack's RESTful API and event model allow for many possibilities.

  • For authentication, Physitrack uses both the pattern described in option 1 (SSO) where Physitrack stores your system's secret and generates an API token for each practitioner which is stored in your system as a shared secret. More on authentication for our RESTful API.
  • RESTful endpoints
    You can use our endpoints to assign templates and get client details. Read about our RESTful endpoints.
  • Events
    We can register various webhooks for you to listen to events. You can combine this with our RESTful endpoints to add a high degree of synchronicity between Physitrack and your system. Read about our events.

5. Your system loads Physitrack inside an iframe

Our iframe integration lets you load Physitrack's UI into an iframe that sits in your UI, at the same time authenticating the practitioner and adding (or opening) the client. This type of integration is possible if you have a web-based system with ample space in your UI to accommodate an iframe that is at least 990 px wide.

For authentication, Physitrack uses either OAuth or the SSO pattern (see 1. above).

Your system loads Physitrack with a JWT parameter for further authentication.

The client in context is automatically added or opened.

Physitrack can optionally prepare a "dashboard" view that is loaded as the default state in the iframe.