IoT Gateway Management API

{
  "success": true,
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4...",
    "token_type": "Bearer",
    "expires_in": 900,
    "user": {
      "id": "usr_8f4a2b1c",
      "username": "admin@iotgateway.io",
      "role": "admin",
      "last_login": "2024-11-15T09:00:00Z"
    }
  }
}

curl -X POST https://api.iotgateway.io/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "admin@iotgateway.io",
    "password": "SecurePass@123"
  }'

import requests

url = "https://api.iotgateway.io/api/v1/auth/login"
payload = {
    "username": "admin@iotgateway.io",
    "password": "SecurePass@123",
    "remember_me": False
}

response = requests.post(url, json=payload)
data = response.json()
access_token = data["data"]["access_token"]
print(f"Token: {access_token[:20]}...")

const response = await fetch('https://api.iotgateway.io/api/v1/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    username: 'admin@iotgateway.io',
    password: 'SecurePass@123',
    remember_me: false
  })
});
const { data } = await response.json();
localStorage.setItem('access_token', data.access_token);

{
  "success": true,
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "token_type": "Bearer",
    "expires_in": 900
  }
}

curl -X POST https://api.iotgateway.io/api/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{"refresh_token": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4..."}'

import requests

response = requests.post(
    "https://api.iotgateway.io/api/v1/auth/refresh",
    json={"refresh_token": stored_refresh_token}
)
new_token = response.json()["data"]["access_token"]

const res = await fetch('/api/v1/auth/refresh', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ refresh_token: localStorage.getItem('refresh_token') })
});
const { data } = await res.json();
localStorage.setItem('access_token', data.access_token);

curl -X DELETE https://api.iotgateway.io/api/v1/auth/logout \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..."

requests.delete("https://api.iotgateway.io/api/v1/auth/logout",
    headers={"Authorization": f"Bearer {access_token}"})

await fetch('/api/v1/auth/logout', {
  method: 'DELETE',
  headers: { 'Authorization': `Bearer ${token}` }
});

curl -X GET "https://api.iotgateway.io/api/v1/gateways?status=online&page=1" \
  -H "Authorization: Bearer YOUR_TOKEN"

import requests

gateways = requests.get(
    "https://api.iotgateway.io/api/v1/gateways",
    headers={"Authorization": f"Bearer {token}"},
    params={"status": "online", "page": 1, "per_page": 20}
).json()
for gw in gateways["data"]:
    print(f"{gw['name']} - {gw['status']}")

const params = new URLSearchParams({ status: 'online', page: 1 });
const res = await fetch(`/api/v1/gateways?${params}`, {
  headers: { 'Authorization': `Bearer ${token}` }
});
const { data } = await res.json();
console.log(`Found ${data.length} gateways`);

curl -X GET https://api.iotgateway.io/api/v1/gateways/gw_a1b2c3d4 \
  -H "Authorization: Bearer YOUR_TOKEN"

gw = requests.get(
    "https://api.iotgateway.io/api/v1/gateways/gw_a1b2c3d4",
    headers={"Authorization": f"Bearer {token}"}
).json()["data"]
print(f"CPU: {gw['cpu_usage']}%")

const res = await fetch('/api/v1/gateways/gw_a1b2c3d4', {
  headers: { 'Authorization': `Bearer ${token}` }
});
const { data } = await res.json();
console.log('Gateway status:', data.status);

{
  "success": true,
  "data": {
    "id": "gw_a1b2c3d4",
    "config": {
      "mqtt_broker": "new-broker.iotgateway.io:1883",
      "poll_interval": 60,
      "encryption": "TLS1.3",
      "log_level": "info"
    },
    "updated_at": "2024-11-15T10:30:00Z",
    "apply_status": "pending"
  }
}

curl -X PUT https://api.iotgateway.io/api/v1/gateways/gw_a1b2c3d4/config \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"poll_interval": 60, "log_level": "info"}'

response = requests.put(
    "https://api.iotgateway.io/api/v1/gateways/gw_a1b2c3d4/config",
    headers={"Authorization": f"Bearer {token}"},
    json={"poll_interval": 60, "log_level": "info"}
)
print(response.json()["data"]["apply_status"])

const res = await fetch('/api/v1/gateways/gw_a1b2c3d4/config', {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ poll_interval: 60, log_level: 'info' })
});

curl -X POST https://api.iotgateway.io/api/v1/gateways/gw_a1b2c3d4/restart \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Applying firmware update", "delay_seconds": 10}'

requests.post(
    "https://api.iotgateway.io/api/v1/gateways/gw_a1b2c3d4/restart",
    headers={"Authorization": f"Bearer {token}"},
    json={"reason": "Manual restart", "delay_seconds": 0}
)

await fetch('/api/v1/gateways/gw_a1b2c3d4/restart', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ reason: 'Config update applied' })
});

curl https://api.iotgateway.io/api/v1/gateways/gw_a1b2c3d4/devices \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('/api/v1/gateways/gw_a1b2c3d4/devices', {
  headers: { 'Authorization': `Bearer ${token}` }
});
const { data } = await res.json();

curl "https://api.iotgateway.io/api/v1/devices?type=temperature&status=online" \
  -H "Authorization: Bearer YOUR_TOKEN"

devices = requests.get(
    "https://api.iotgateway.io/api/v1/devices",
    headers={"Authorization": f"Bearer {token}"},
    params={"type": "temperature", "status": "online"}
).json()["data"]

const res = await fetch('/api/v1/devices?type=temperature&status=online', {
  headers: { 'Authorization': `Bearer ${token}` }
});
const { data, meta } = await res.json();
console.log(`${meta.total} devices found`);

curl https://api.iotgateway.io/api/v1/devices/dev_x1y2z3 \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('/api/v1/devices/dev_x1y2z3', {
  headers: { 'Authorization': `Bearer ${token}` }
});
const { data } = await res.json();

{
  "success": true,
  "data": {
    "id": "dev_x1y2z3",
    "name": "TempSensor-01-Renamed",
    "location": "Server Room B",
    "thresholds": { "min": 10.0, "max": 40.0 },
    "updated_at": "2024-11-15T10:35:00Z"
  }
}

curl -X PUT https://api.iotgateway.io/api/v1/devices/dev_x1y2z3 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "TempSensor-01-Renamed", "thresholds": {"min": 10, "max": 40}}'

await fetch('/api/v1/devices/dev_x1y2z3', {
  method: 'PUT',
  headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'New Name', thresholds: { min: 10, max: 40 } })
});

curl -X DELETE https://api.iotgateway.io/api/v1/devices/dev_x1y2z3 \
  -H "Authorization: Bearer YOUR_TOKEN"

await fetch('/api/v1/devices/dev_x1y2z3', {
  method: 'DELETE',
  headers: { 'Authorization': `Bearer ${token}` }
});

curl "https://api.iotgateway.io/api/v1/alerts?severity=critical&acknowledged=false" \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('/api/v1/alerts?severity=critical&acknowledged=false', {
  headers: { 'Authorization': `Bearer ${token}` }
});

{
  "success": true,
  "data": {
    "acknowledged": 2,
    "failed": 0,
    "acknowledged_at": "2024-11-15T10:45:00Z"
  }
}

curl -X POST https://api.iotgateway.io/api/v1/alerts/acknowledge \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"alert_ids": ["alert_9f8e7d6c"], "note": "Resolved"}'

await fetch('/api/v1/alerts/acknowledge', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ alert_ids: ['alert_9f8e7d6c'], note: 'Resolved' })
});

curl -X DELETE https://api.iotgateway.io/api/v1/alerts/alert_9f8e7d6c \
  -H "Authorization: Bearer YOUR_TOKEN"

await fetch('/api/v1/alerts/alert_9f8e7d6c', {
  method: 'DELETE', headers: { 'Authorization': `Bearer ${token}` }
});

{
  "success": true,
  "data": {
    "diagnosis_id": "diag_m7n8p9q0",
    "target": { "type": "gateway", "id": "gw_a1b2c3d4" },
    "status": "completed",
    "health_score": 74,
    "anomalies": [
      {
        "type": "memory_leak",
        "severity": "warning",
        "description": "Memory usage increasing ~2% per hour over last 48h",
        "detected_at": "2024-11-15T06:00:00Z"
      }
    ],
    "recommendations": ["Schedule gateway restart within 24h", "Update firmware to v2.4.2"],
    "analyzed_at": "2024-11-15T10:30:00Z",
    "duration_ms": 3240
  }
}

curl -X POST https://api.iotgateway.io/api/v1/ai/diagnose \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_type":"gateway","target_id":"gw_a1b2c3d4","lookback_hours":48}'

result = requests.post(
    "https://api.iotgateway.io/api/v1/ai/diagnose",
    headers={"Authorization": f"Bearer {token}"},
    json={"target_type": "gateway", "target_id": "gw_a1b2c3d4", "lookback_hours": 48}
).json()
print(f"Health score: {result['data']['health_score']}")

const res = await fetch('/api/v1/ai/diagnose', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ target_type: 'gateway', target_id: 'gw_a1b2c3d4' })
});
const { data } = await res.json();
console.log(`Health: ${data.health_score}/100`);

curl "https://api.iotgateway.io/api/v1/ai/logs?type=diagnosis&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('/api/v1/ai/logs?type=diagnosis&limit=20', {
  headers: { 'Authorization': `Bearer ${token}` }
});

{
  "success": true,
  "data": {
    "reply": "Gateway-Alpha is experiencing a gradual memory leak. Memory has grown from 62% to 78% over the past 48 hours, increasing approximately 2% per hour. I recommend scheduling a restart within the next 24 hours. Would you like me to schedule the restart automatically?",
    "session_id": "sess_abc123",
    "actions_taken": [],
    "confidence": 0.92,
    "sources": ["diagnosis_diag_m7n8p9q0", "telemetry_last_48h"]
  }
}

curl -X POST https://api.iotgateway.io/api/v1/ai/chat \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "What is the health status of all gateways?"}'

response = requests.post(
    "https://api.iotgateway.io/api/v1/ai/chat",
    headers={"Authorization": f"Bearer {token}"},
    json={"message": "Are there any critical alerts right now?", "session_id": session_id}
).json()
print(response["data"]["reply"])

const res = await fetch('/api/v1/ai/chat', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ message: 'Summarize all critical alerts', session_id: sessionId })
});
const { data } = await res.json();
console.log(data.reply);

curl https://api.iotgateway.io/api/v1/ai/recommendations \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('/api/v1/ai/recommendations', {
  headers: { 'Authorization': `Bearer ${token}` }
});
const { data } = await res.json();
data.recommendations.forEach(r => console.log(`[${r.priority}] ${r.title}`));

curl "https://api.iotgateway.io/api/v1/analytics/traffic?interval=day&days=7" \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('/api/v1/analytics/traffic?interval=day&days=7', {
  headers: { 'Authorization': `Bearer ${token}` }
});

curl https://api.iotgateway.io/api/v1/analytics/devices \
  -H "Authorization: Bearer YOUR_TOKEN"

const { data } = await fetch('/api/v1/analytics/devices', {
  headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());
console.log(`Online rate: ${(data.online/data.total*100).toFixed(1)}%`);

curl https://api.iotgateway.io/api/v1/analytics/alerts \
  -H "Authorization: Bearer YOUR_TOKEN"

const { data } = await fetch('/api/v1/analytics/alerts', {
  headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());
console.log(`MTTA: ${data.mtta_minutes} min`);

curl "https://api.iotgateway.io/api/v1/analytics/performance?metric=all" \
  -H "Authorization: Bearer YOUR_TOKEN"

const { data } = await fetch('/api/v1/analytics/performance?metric=all', {
  headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());
console.log(`p95 latency: ${data.api_latency.p95_ms}ms`);