Swagger SDK Generation

Software Development Kits (SDKs) include all the necessary toolkits to build an application ans call the local APIs. If an API consumer wants to build an application, they  need to generate client side SDK for a supported language/framework and use it to write a software application to invoke the APIs. OpenMRS FHIR module provide the facility to generate the swagger SDK for the FHIR API that expose by the module. With this SDK, user who wants to build a software application which require to access OpenMRS FHIR API will be benefited. This allow user to generate SDK for their preferred language and use it.

Generating server stubs and client SDKs

The generate SDK option is available in the FHIR module swagger documentation interface. Swagger SDK generation library provide interface to generate SDKs for more than 30 most popular software programming languages including java,c++, csharp and etc. User first need to navigate to FHIR module swagger documentation user interface as follow.

                                                                                                                                                                                       Generate SDK Option in Swagger Documentation Page

After navigating to the swagger documentation user interface page, user can click generate SDK button to choose and download the SDK in preferred language.

                                                                                                                                                                                                                 Generate SDK Popup

The SDK for the preferred language will be generated and download to the target machine which contains the zip archive name with the format of OPENMRS-FHIR-CLIENT_{language}.zip

Using SDK

The demo client which uses generated Java SDK can be found in https://github.com/eunice18/demo-sdk-client.