Skip to content

LifeOmic API Examples

Source location - lifeomic/api-examples

This repository contains usage examples of the LifeOmic APIs. Please see the README in the graphql directory for additional details.

Getting Started

LifeOmic CLI

To start, download and install the LifeOmic CLI. This is done via installing with npm or yarn like so:

npm install -g @lifeomic/cli

yarn global add @lifeomic/cli

Once installed, run the setup: lo setup to configure usage of the CLI tool.

API Usage

Most of LifeOmic's APIs (with a few exceptions) require valid authentication and authorization, done by utilizing the Authorization header in requests.

In these cases, a valid token must be present in the header in the form of Bearer {token}.

To get a token to test the APIs with, the CLI can be used: lo auth -c. The -c parameter copies the token to the clipboard.

The api url is: https://api.us.lifeomic.com

GraphQL API

The URL for the GraphQL endpoint is located at {baseUrl}/v1/graphql

The schema can be downloaded using the Apollo CLI, provided an authorization header is supplied.

(Optional) For types, we utilize Apollog Codegen: Once the Apollo CLI is installed (either globally or localling in the project), apollo codegen:generate --clientSchema={path/to/schema}.

Bitesize Examples

The bitesize directory contains standalone examples of various means of using the GraphQL api.

observations.ts

Included is a sample for handlig Observations, a type that encompases various readings for a patient, such as body wieght or height.

lifeomic-sample-graphql-client-app

This is a full, runnable React Native app. For authentication, you will need to copy the .env.sample file in the root of the directory to .env, and provide a token as the value, which you can obtain from the LifeOmic CLI: lo auth -c. Currently, this renders a list of weight observations for your user.


Last update: 2021-05-07