Skip to content
/ API Public

Official 1080Motion gRPC API containing protobuf files and documentation of how to use it.

Notifications You must be signed in to change notification settings

1080Motion/API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

1080Motion API

Welcome to the official 1080Motion API!

The API provides programmatic access to training data recorded on 1080 sprint and quantum machines. Using the API customers and/or third party athlete management systems can easily integrate the API into their platforms.

For more details and instructions of how to use the API please visit the wiki pages

Accessing the API

Note: There are two flavors of the API: a REST based API using basic HTTP requests, and one using gRPC and protocol buffers. The recommended flavor is the REST API because it is easier to interact with.

The HTTP/REST API is hosted at https://publicapi.1080motion.com.

The gRPC API is hosted at https://publicapi-grpc.1080motion.com/.

API key

To access data for an account you also need an api key related to that account. These keys can be created by the administrator for the instructor account from the 1080 web app. After logging in as an administrator, click on the name in the top right corner and select "API Keys" in the drop-down menu.

If you have questions or cannot generate keys, contact 1080Motion support.

The same API key is used on both flavors APIs

See the wiki page on authentication for more details.

Getting started

The HTTP API can be tested without any additional tooling by accessing the swagger page hosted on the API Server.

It's also possible to use a tool such as Postman to query the API.

To use the gRPC API, you need to generate code from the .proto files

Why two APIs?

Historical reasons. Technically, the gRPC based API has better performance thanks to efficient data serialization and code generation.

The negative side is that it's a steep learning curve to get started, especially from higher level languages such as python or R which many want to use.

This lead us to develop the new, simpler web API.

For the time being, both flavors of the API will continue to live side by side.

Read more about gRPC over at:

About

Official 1080Motion gRPC API containing protobuf files and documentation of how to use it.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •