https://api.aurrahome.com/v1

POST https://api.aurrahome.com/v1/auth/token
Content-Type: application/json

{
  "client_id":     "acc_a1b2c3d4",
  "client_secret": "sk_live_••••••••••••",
  "grant_type":    "client_credentials"
}

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type":   "Bearer",
  "expires_in":   3600
}

import requests

def get_token(client_id, client_secret):
    resp = requests.post(
        "https://api.aurrahome.com/v1/auth/token",
        json={
            "client_id":     client_id,
            "client_secret": client_secret,
            "grant_type":    "client_credentials"
        }
    )
    return resp.json()["access_token"]

TOKEN   = get_token(CLIENT_ID, CLIENT_SECRET)
HEADERS = {"Authorization": f"Bearer {TOKEN}"}

{
  "maintenance_needed": true,
  "prediction": {
    "issue":              "Compressor bearing degradation",
    "confidence":         0.87,
    "recommended_action": "Schedule HVAC inspection within 14 days"
  },
  "last_service": "2024-08-12"
}

{ "temperature":73, "humidity":42, "mode":"heat", "eco_mode":false, "status":"active" }

resp = requests.post(
    f"{BASE}/thermostat/aurra_001/setpoint",
    json={"temperature": 72, "mode": "cool"},
    headers=HEADERS
)
print(resp.json())

{
  "name": "Workday Routine",
  "blocks": [
    { "label":"Morning", "start":"04:00", "end":"08:00",
      "heat":70, "cool":74, "days":["mon","tue","wed","thu","fri"] },
    { "label":"Day",     "start":"08:00", "end":"16:30",
      "heat":65, "cool":78, "days":["mon","tue","wed","thu","fri"] },
    { "label":"Evening", "start":"16:30", "end":"22:00",
      "heat":72, "cool":73, "days":["mon","tue","wed","thu","fri"] },
    { "label":"Night",   "start":"22:00", "end":"04:00",
      "heat":68, "cool":76, "days":["mon","tue","wed","thu","fri"] }
  ]
}

POST https://your-server.com/aurra/webhook
Content-Type: application/json
X-AURRA-Signature: sha256=<hmac_signature>

{
  "event":     "predictive.alert_created",
  "timestamp": "2025-04-22T14:33:10Z",
  "data": {
    "device_id":  "aurra_001",
    "issue":      "Compressor bearing degradation",
    "confidence": 0.87,
    "action":     "Schedule HVAC inspection within 14 days"
  }
}

import hmac, hashlib

def verify_signature(payload_bytes, header_sig, secret):
    expected = hmac.new(
        secret.encode(), payload_bytes, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", header_sig)

# Python
pip install aurra-sdk

# JavaScript / Node.js
npm install @aurra/sdk

import requests

BASE = "https://api.aurrahome.com/v1"

# 1. Authenticate
token_resp = requests.post(f"{BASE}/auth/token", json={
    "client_id":     CLIENT_ID,
    "client_secret": CLIENT_SECRET,
    "grant_type":    "client_credentials"
})
TOKEN   = token_resp.json()["access_token"]
HEADERS = {"Authorization": f"Bearer {TOKEN}"}

# 2. Get current thermostat status
status = requests.get(f"{BASE}/thermostat/aurra_001/status", headers=HEADERS).json()
print(f"Current: {status['temperature']}°F  Mode: {status['mode']}")

# 3. Set temperature
requests.post(f"{BASE}/thermostat/aurra_001/setpoint",
    json={"temperature": 72, "mode": "cool"}, headers=HEADERS)

# 4. Check predictive maintenance status
pred = requests.get(f"{BASE}/predictive/hvac/aurra_001/status", headers=HEADERS).json()
if pred["maintenance_needed"]:
    print(f"ALERT: {pred['prediction']['issue']}")
    print(f"Confidence: {pred['prediction']['confidence']:.0%}")
    print(f"Action: {pred['prediction']['recommended_action']}")

const BASE = "https://api.aurrahome.com/v1";

// Fetch current thermostat status
const status = await fetch(`${BASE}/thermostat/aurra_001/status`, {
  headers: { Authorization: `Bearer ${ACCESS_TOKEN}` }
}).then(r => r.json());

console.log(`${status.temperature}°F | ${status.mode} | eco: ${status.eco_mode}`);

// Set temperature to 70°F, heating mode
await fetch(`${BASE}/thermostat/aurra_001/setpoint`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${ACCESS_TOKEN}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ temperature: 70, mode: "heat" })
});

{
  "error": {
    "code":    "UNAUTHORIZED",
    "message": "Bearer token has expired. Request a new token.",
    "docs":    "https://docs.aurrahome.com/errors/UNAUTHORIZED"
  }
}