Important
This project has been archived in favour of using https://github.com/deepmap/oapi-codegen to generate the necessary libraries directly from Oura's OpenAPI specification.
opai-codegen generates files almost identical to those in this project, but comes with the advantage that it reads directly from Oura's spec file so all you need to do is rebuild your app and you get support for the latest endpoints.
Oura's spec is well maintained as features are added, doesn't have errors and works a treat. If there are any problems as a result of changes to the spec, you have a formal support channel in for the form of Oura too.
An unofficial Go client for the Oura Cloud API v1 and Oura Cloud API v2.
Use Go to fetch the latest version of the package.
go get -u 'github.com/lildude/oura'Depending on your requirements, you will need an access token to query the API. This can be a personal access token or a full OAuth2 authenticated access token.
See the section on Authentication in the Oura Cloud API Docs for more information the authentication methods.
The simplest approach for accessing your own data is to use a personal access token like this:
package main
import (
"context"
"fmt"
"os"
"github.com/joho/godotenv"
"github.com/lildude/oura"
"golang.org/x/oauth2"
)
func main() {
godotenv.Load(".env")
ts := oauth2.StaticTokenSource(&oauth2.Token{AccessToken: os.Getenv("OURA_ACCESS_TOKEN")})
ctx := context.Background()
tc := oauth2.NewClient(ctx, ts)
cl := oura.NewClient(tc)
info, _, err := cl.PersonalInfo(ctx)
if err != nil {
fmt.Println(err)
}
fmt.Println(info.Age, info.Gender, info.Weight, info.Email)
}This library supports both v1 and v2 of the Oura API. Function names are in the plural form, where appropriate, with the v1 API calls prefixed with Get. For example, GetActivities queries the v1 API, and DailyActivities queries the v2 API. GetUserInfo queries the v1 API and PersonalInfo queries the v2 API.
This project uses GoReleaser via GitHub Actions to make the releases quick and easy. When I'm ready for a new release, I push a new tag and the workflow takes care of things.