Hey

The token needed to initialise the Terra iOS SDK must be generated by making a POST request to the generateAuthToken API endpoint from your backend server, then passed into the frontend (the mobile device). This flow ensures that users are authenticated securely and your private API keys are not exposed. Also, each token has an expiry time of 180 seconds (3 minutes)

Implement a backend endpoint that looks something like this:

@app.get("/api/token")
def generate_auth_token(request: Request):
	# ...
	# verify that the user making this request is signed into your app

	req = requests.post("https://api.tryterra.co/v2/auth/generateAuthToken", headers={
		"dev-id": "<YOUR-DEV-ID>",
		"x-api-key": "<YOUR-API-KEY>"
	})

	if not req.ok:
		return { "error": "Failed to generate token" }

	return req.json()

Then, use the token in your mobile app like so:

var request = URLRequest(url: URL(string: "<YOUR-BACKEND-URL>/api/token")!, timeoutInterval: Double.infinity)
request.httpMethod = "POST"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
	guard let data = data else { return }
	print(String(data: data, encoding: .utf8)!)
	
	let json = try? JSONSerialization.jsonObject(with: data, options: [])
    if let json = json as? [String: Any] {
        let token = json["token"]
		// then use this token when calling initConnection
    }
}

task.resume()