REST API Endpoints | Terra Docs

Generates an authentication token for the Terra mobile SDKs

post

Creates a token to be used with initConnection() functions in the Terra mobile SDKs in order to create a user record for Apple Health or Samsung Health (or equivalent)

Authorizations

Header parameters

dev-idstringrequired

your developer ID

Example: testingTerra

x-api-keystringrequired

your API key

Example: OtHJok60oQmT8zhnUWc4SWBJI7ztPTs88C0gOsJJ

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.tryterra.co/v2/auth/generateAuthToken' \
  --header 'x-api-key: text' \
  --header 'dev-id: text'

200

404

{
    "status": "success",
    "token": "250c68b9c21b78e40e7a3285a2d538d3bc24aabd3b4c76a782fb0a571ca4501d",
    "expires_in": 180
}

200

Stream - Generate developer token

post

Endpoint for generation of a token for a developer (consumer) connection

Authorizations

Header parameters

dev-idstringrequired

your developer ID

x-api-keystringrequired

your API key

Responses

application/json

text/plain

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://ws.tryterra.co/auth/developer' \
  --header 'x-api-key: text' \
  --header 'dev-id: text'

200

403

{
  "token": "cG9RvLY5.yvKm778XMIPm1ig93BJEoRCVGHzlrBNjzWdeXePTaMM"
}

Successful response

Stream - Generate user token

post

Endpoint for generation of a token for a user (producer) connection

Authorizations

Query parameters

idstringoptional

The ID of the user to generate a token for

Header parameters

dev-idstringrequired

your developer ID

x-api-keystringrequired

your API key

Responses

application/json

text/plain

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://ws.tryterra.co/auth/user' \
  --header 'x-api-key: text' \
  --header 'dev-id: text'

200

403

{
  "token": "OTYwNWFi5ZWQMTAxMjg0Y2Qw.gzrPzZcS3Gy8QDOxbiPRwu30PTB3VxW0eE"
}

Successful response