Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Growth-tastic: A BlueButton+ Tutorial
Growth-tastic has built a killer app where parents watch their children grow. The dev team has worked out the user experience including visualization of a child's weight, height, and body mass index. Now all they need is a way to fuel the app with health data from the pediatrician's office.
This hands-on tutorial will show you how to integrate healthcare data into your app, using BlueButton+. Following the progress of "Growth-tastic" (a fictional company with a slick patient-facing app), we'll:
Learn two ways to get the data:
- BlueButton+ Push (Direct Project secure e-mail)
- BlueButton+ Pull (REST and OAuth2)
Practice using the data:
- Consolidated CDA format (C-CDA)
By the end of this tutorial, you'll have a functional Pediatric Growth Chart app fueled by BlueButton+ data. Along the way, you'll learn about a variety of open-source tools that can simplify the process.
Our Plan for Today
Version 0: Fixture
We'll start with a simple web app that displays a growth chart using hard-coded sample data.
Version 1: BlueButton+ Push
We'll extend the app to obtain data via BlueButton+ Push, a protocol based on the Direct Project's specification for secure e-mail. We'll also learn how to use Consolidated CDA, the XML format in which data are delivered.
Version 2: BlueButton+ Pull
After implementing BB+ Push messaging, we'll take a quick look at a new specification that simplifies the process of obtaining patient data. BB+ Pull help users authorize apps to access data via a familiar OAuth2 workflow. Authorized apps can then request clinical summary documents via a RESTful HTTP interface.
Enough planning! Without further ado, let's jump into the tutorial.