Informatie voor ontwikkelaars
Informatie voor ontwikkelaars
Physitrack integreert met vele EPD- en praktijksoftwareleveranciers om praktijkhouders en zorgverleners tijd te besparen en makkelijk gegevens uit te kunnen wisselen.
Als u een EPD/praktijksoftware hebt, helpen wij u graag bij het toevoegen van een integratie tussen Physitrack en uw platform. Lees hieronder verder.
Soorten integratie
De meeste EPD's en praktijksoftware-oplossingen die met Physitrack integreren, maken gebruik van (een combinatie van) de onderstaande integraties.
- Single sign on (SSO) & kopieer patiënt van uw systeem naar Physitrack
- Webhook om PDF-versie van toegewezen (of bijgewerkt) programma te downloaden van Physitrack naar uw systeem
- Physitrack RESTful API schrijven: toegang tot Physitrack functionaliteit vanuit uw UI (bijv. een sjabloon aan een patiënt toewijzen).
- Physitrack RESTful API lezen: webhooks toevoegen om te luisteren naar onze gebeurtenissen en automatisch patiëntuitkomstgegevens verzamelen, zoals adherentie, PROM-scores en berichten.
Documentatie
Aan de slag
- Beslis over het type integratie dat u wenst op te zetten
- E-mail support@physitrack.com zodat we u op onze staging-omgeving kunnen instellen.
- Ontwikkel en test uw integratie
- Schrijf duidelijke stap voor stap documentatie voor uw gebruikers. Voeg screenshots toe.
- Stuur ons een e-mail wanneer u uw integratie hebt voltooid. Voeg informatie bij zodat wij kunnen inloggen op uw systeem en de integratie van onze kant kunnen testen.
Let op:
- We accepteren gewoonlijk alleen integraties met commerciële patiëntbeheersystemen / EHR's die minstens 500 zorgverleners hebben.
We maken uitzonderingen voor grotere praktijken (50+ zorgverleners die zich abonneren op Physitrack) die interne patiëntbeheersystemen hebben. - Afhankelijk van de commerciële relatie tussen uw systeem en Physitrack, kunnen wij u vragen een API-gebruiksovereenkomst te ondertekenen voordat u toegang krijgt tot onze API.
1. API v1 (SSO + kopiëren/openen patiënt)
Dit is onze meest basale vorm van integratie. Robuust, eenvoudig te implementeren en zeer handig voor de zorgverlener: de zorgverlener logt in op Physitrack en voegt de patiënt toe/opent hem met één klik.
Authenticatie gebeurt via een gedeeld geheim (uw systeem genereert een token dat wordt toegevoegd aan de zorgverlener's account in Physitrack). Wij ondersteunen ook OAuth, waarbij uw systeem de OAuth-provider is.
- De zorgverlener klikt op een UI-element in uw UI (bv. "Open patiënt in Physitrack").
- Dit activeert dan een HTTP POST verzoek van uw systeem naar Physitrack met de vereiste gegevens.
- Physitrack stuurt dan een 302 terug naar de browser van de zorgverlener, en leidt hem door naar de patiënt.
2. API v2 (RESTful API)
Als u uw systeem wilt verrijken met kernfunctionaliteit van Physitrack , zoals het toewijzen van templates aan patiënten, of als u automatisch gegevens over patiëntentrouw van Physitrack in uw systeem wilt binnenhalen, bieden de RESTful API en het eventmodel van Physitrack vele mogelijkheden.
- Voor authenticatie:
Als een zorgverlener behoort tot een Physitrack Direct account, moet elk verzoek het API token dat is gegenereerd door Physitrack in de header bevatten.
Merk op dat API toegang moet worden ingeschakeld door Physitrack voor de Physitrack Direct account in kwestie.
Als een zorgverlener niet tot een Physitrack Direct account behoort, moet elk verzoek zowel het API token dat door Physitrack is gegenereerd in de header bevatten als het geheim dat u voor API v1 toegang hebt gegenereerd. Meer over authenticatie voor onze RESTful API. - RESTful endpoints
U kunt onze endpoints gebruiken om templates toe te wijzen en patiëntgegevens op te vragen. Lees meer over onze RESTful endpoints. - Gebeurtenissen
Wij kunnen verschillende webhooks voor u registreren om te luisteren naar gebeurtenissen. U kunt dit combineren met onze RESTful endpoints om een hoge mate van synchroniciteit toe te voegen tussen Physitrack en uw systeem. Lees meer over onze events.