Swift-SMART is a full client implementation of the 🔥FHIR specification for building apps that interact with healthcare data through SMART on FHIR. Written in Swift 2 it is compatible with iOS 8 and OS X 10.9 and newer and requires Xcode 7 or newer.

Versioning

Due to the complications of combining two volatile technologies, here's an overview of which version numbers use which Swift and FHIR versions. The master branch should always compile and is on (point releases of) these main versions. See the develop branch or specific feature/x branches for new Swift or FHIR versions, and check the tags.

Version	Swift	FHIR
2.3	2.0-2.2	1.0.2.7202	DSTU 2 (+ technical errata)
2.2	2.0-2.2	1.0.2.7202	DSTU 2 (+ technical errata)
2.1	2.0-2.2	1.0.1.7108	DSTU 2
2.0	2.0-2.2	0.5.0.5149	DSTU 2 Ballot, May 2015
1.0	1.2	0.5.0.5149	DSTU 2 Ballot, May 2015
0.2	1.1	0.5.0.5149	DSTU 2 Ballot, May 2015
0.1	1.0	0.0.81.2382	DSTU 1

Resources

• Programming Guide with code examples
• Technical Documentation of classes, properties and methods
• Medication List sample app
• SMART on FHIR API documentation

QuickStart

See the programming guide for more code examples and details.

The following is the minimal setup working against our reference implementation. On first authentication it will register the client with our server, then proceed to retrieve a token. The app must register the redirect URL scheme so it can be notified.

import SMART

// create the client
let smart = Client(
    baseURL: "https://fhir-api-dstu2.smarthealthit.org",
    settings: [
        "redirect": "smartapp://callback",    // must be registered
    ]
)

// authorize, then search for prescriptions
smart.authorize() { patient, error in
    if nil != error || nil == patient {
        // report error
    }
    else {
        MedicationPrescription.search(["patient": patient!.id])
        .perform(smart.server) { bundle, error in
            if nil != error {
                // report error
            }
            else {
                var meds = bundle?.entry?
                    .filter() { return $0.resource is MedicationPrescription }
                    .map() { return $0.resource as! MedicationPrescription }
                
                // now `meds` holds all known patient prescriptions (or is nil)
            }
        }
    }
}

License

This work is Apache 2 licensed.