{
  "name": "Interface Networld API Gateway",
  "version": "0.3.0",
  "publicBase": "https://interfacenetworld.com/api",
  "authentication": "Interface Accounts + opaque sessions + API keys",
  "routes": [
    {
      "method": "GET",
      "path": "/api/health",
      "purpose": "Core health check"
    },
    {
      "method": "GET",
      "path": "/api/system",
      "purpose": "Runtime and service readiness"
    },
    {
      "method": "GET",
      "path": "/api/apps",
      "purpose": "Application registry"
    },
    {
      "method": "POST",
      "path": "/api/auth/register",
      "purpose": "Create Interface account"
    },
    {
      "method": "POST",
      "path": "/api/auth/login",
      "purpose": "Create authenticated session"
    },
    {
      "method": "POST",
      "path": "/api/auth/logout",
      "purpose": "End session"
    },
    {
      "method": "GET",
      "path": "/api/auth/me",
      "purpose": "Current account"
    },
    {
      "method": "GET/POST",
      "path": "/api/developer/keys",
      "purpose": "List or create API keys"
    },
    {
      "method": "DELETE",
      "path": "/api/developer/keys/:id",
      "purpose": "Revoke API key"
    },
    {
      "method": "POST",
      "path": "/api/storage/upload",
      "purpose": "Authenticated R2 upload"
    },
    {
      "method": "GET",
      "path": "/api/storage/files",
      "purpose": "List private files"
    },
    {
      "method": "GET/DELETE",
      "path": "/api/storage/files/:id",
      "purpose": "Download or delete private file"
    },
    {
      "method": "GET",
      "path": "/api/deployments",
      "purpose": "Recent deployments"
    },
    {
      "method": "GET",
      "path": "/api/events",
      "purpose": "Recent platform events"
    }
  ]
}