Account setup and API keys

This guide walks you through obtaining the API keys necessary to start using our services. Currently, account set up for new partners is done manually but we will change this in the future!

N.B Your credentials will initially only work for sandbox environment. Production credentials will not be sent until later.

Two Scenarios

1. Existing Terra Customer

Use existing testing credentials to configure webhook endpoint

curl --location --request PATCH \
  'https://diagnostics-sandbox.tryterra.co/api/v1/clients/webhook-url' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic <YOUR_CLIENT_ID:YOUR_CLIENT_SECRET_BASE64>'
  --data '{
    "webhook_url": "https://your-domain.com/webhooks/terra"
  }'

import requests

url = "https://diagnostics-sandbox.tryterra.co/api/v1/clients/webhook-url"

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Basic <YOUR_CLIENT_ID:YOUR_CLIENT_SECRET_BASE64>'
}

data = {
    "webhook_url": "https://your-domain.com/webhooks/terra"
}

response = requests.patch(url, headers=headers, json=data)

print(response.text)
print(response.status_code)

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://diagnostics-sandbox.tryterra.co/api/v1/clients/webhook-url"

	payload := map[string]string{
		"webhook_url": "https://your-domain.com/webhooks/terra",
	}
	jsonData, err := json.Marshal(payload)
	if err != nil {
		panic(err)
	}

	client := &http.Client{}
	req, err := http.NewRequest("PATCH", url, bytes.NewBuffer(jsonData))
	if err != nil {
		panic(err)
	}

	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Basic <YOUR_CLIENT_ID:YOUR_CLIENT_SECRET_BASE64>")

	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}

	fmt.Println(string(body))
}

Start ordering!

2. New Customer

Contact [email protected]
Provide necessary information (payment details etc.)
Provide endpoint to receive webhooks
Receive credentials
Start ordering!!

PreviousWhat is Vantage API?NextOrdering your first test

Last updated 1 month ago

Was this helpful?

hashtagTwo Scenarios

hashtag1. Existing Terra Customer

hashtag2. New Customer

Two Scenarios

1. Existing Terra Customer

2. New Customer