API Reference

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

https://api.sophonz.com/v1

GET /applications

{
  "applications": [
    {
      "id": "app_123",
      "name": "My Application",
      "status": "active",
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-15T12:30:00Z"
    }
  ],
  "total": 1,
  "page": 1
}

GET /applications/{id}

{
  "id": "app_123",
  "name": "My Application",
  "description": "Application description",
  "status": "active",
  "environment": "production",
  "metrics": {
    "uptime": 99.9,
    "response_time": 245,
    "error_rate": 0.01
  }
}

POST /applications

{
  "name": "New Application",
  "description": "Description of the application",
  "environment": "production",
  "config": {
    "monitoring": true,
    "alerts": true
  }
}

GET /applications/{id}/metrics

{
  "metric": "response_time",
  "granularity": "5m",
  "data": [
    {
      "timestamp": "2024-01-15T12:00:00Z",
      "value": 245.5
    },
    {
      "timestamp": "2024-01-15T12:05:00Z",
      "value": 238.2
    }
  ]
}

POST /applications/{id}/alerts

{
  "name": "High Error Rate",
  "condition": {
    "metric": "error_rate",
    "operator": ">",
    "threshold": 0.05
  },
  "actions": [
    {
      "type": "email",
      "recipients": ["admin@company.com"]
    },
    {
      "type": "slack",
      "channel": "#alerts"
    }
  ]
}

GET /applications/{id}/insights

{
  "insights": [
    {
      "id": "insight_123",
      "type": "performance",
      "severity": "medium",
      "title": "Response time increase detected",
      "description": "Average response time increased by 40% in the last hour",
      "recommendation": "Consider scaling your application or optimizing slow queries",
      "timestamp": "2024-01-15T12:30:00Z"
    }
  ]
}

GET /applications/{id}/predictions

{
  "metric": "response_time",
  "horizon": "24h",
  "predictions": [
    {
      "timestamp": "2024-01-15T13:00:00Z",
      "predicted_value": 250.3,
      "confidence": 0.85
    }
  ]
}

GET /applications/{id}/deployments

{
  "deployments": [
    {
      "id": "deploy_123",
      "version": "v1.2.4",
      "status": "success",
      "started_at": "2024-01-15T10:00:00Z",
      "completed_at": "2024-01-15T10:05:00Z",
      "changes": [
        "Fixed payment processing bug",
        "Updated user interface"
      ]
    }
  ]
}

POST /applications/{id}/deployments

{
  "version": "v1.2.5",
  "description": "Bug fixes and performance improvements",
  "config": {
    "rollback_on_error": true,
    "health_check_url": "/health"
  }
}

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1642248000

import { Sophonz } from '@sophonz/sdk';

const client = new Sophonz({
  apiKey: 'your-api-key'
});

const apps = await client.applications.list();
console.log(apps);

from sophonz import Client

client = Client(api_key='your-api-key')
apps = client.applications.list()
print(apps)