1## REST API Endpoints
2 
3```
4GET    /zones/{zone_id}/spectrum/apps                    # List apps
5POST   /zones/{zone_id}/spectrum/apps                    # Create app
6GET    /zones/{zone_id}/spectrum/apps/{app_id}           # Get app
7PUT    /zones/{zone_id}/spectrum/apps/{app_id}           # Update app
8DELETE /zones/{zone_id}/spectrum/apps/{app_id}           # Delete app
9 
10GET    /zones/{zone_id}/spectrum/analytics/aggregate/current
11GET    /zones/{zone_id}/spectrum/analytics/events/bytime
12GET    /zones/{zone_id}/spectrum/analytics/events/summary
13```
14 
15## Request/Response Schemas
16 
17### CreateSpectrumAppRequest
18 
19```typescript
20interface CreateSpectrumAppRequest {
21  protocol: string;                    // "tcp/22", "udp/53"
22  dns: {
23    type: "CNAME" | "ADDRESS";
24    name: string;                      // "ssh.example.com"
25  };
26  origin_direct?: string[];            // ["tcp://192.0.2.1:22"]
27  origin_dns?: { name: string };       // {"name": "origin.example.com"}
28  origin_port?: number | { start: number; end: number };
29  proxy_protocol?: "off" | "v1" | "v2" | "simple";
30  ip_firewall?: boolean;
31  tls?: "off" | "flexible" | "full" | "strict";
32  edge_ips?: {
33    type: "dynamic" | "static";
34    connectivity: "all" | "ipv4" | "ipv6";
35  };
36  traffic_type?: "direct" | "http" | "https";
37  argo_smart_routing?: boolean;
38}
39```
40 
41### SpectrumApp Response
42 
43```typescript
44interface SpectrumApp {
45  id: string;
46  protocol: string;
47  dns: { type: string; name: string };
48  origin_direct?: string[];
49  origin_dns?: { name: string };
50  origin_port?: number | { start: number; end: number };
51  proxy_protocol: string;
52  ip_firewall: boolean;
53  tls: string;
54  edge_ips: { type: string; connectivity: string; ips?: string[] };
55  argo_smart_routing: boolean;
56  created_on: string;
57  modified_on: string;
58}
59```
60 
61## TypeScript SDK
62 
63```typescript
64import Cloudflare from 'cloudflare';
65 
66const client = new Cloudflare({ apiToken: process.env.CLOUDFLARE_API_TOKEN });
67 
68// Create
69const app = await client.spectrum.apps.create({
70  zone_id: 'your-zone-id',
71  protocol: 'tcp/22',
72  dns: { type: 'CNAME', name: 'ssh.example.com' },
73  origin_direct: ['tcp://192.0.2.1:22'],
74  ip_firewall: true,
75  tls: 'off',
76});
77 
78// List
79const apps = await client.spectrum.apps.list({ zone_id: 'your-zone-id' });
80 
81// Get
82const appDetails = await client.spectrum.apps.get({ zone_id: 'your-zone-id', app_id: app.id });
83 
84// Update
85await client.spectrum.apps.update({ zone_id: 'your-zone-id', app_id: app.id, tls: 'full' });
86 
87// Delete
88await client.spectrum.apps.delete({ zone_id: 'your-zone-id', app_id: app.id });
89 
90// Analytics
91const analytics = await client.spectrum.analytics.aggregate({
92  zone_id: 'your-zone-id',
93  metrics: ['bytesIngress', 'bytesEgress'],
94  since: new Date(Date.now() - 3600000).toISOString(),
95});
96```
97 
98## Python SDK
99 
100```python
101from cloudflare import Cloudflare
102 
103client = Cloudflare(api_token="your-api-token")
104 
105# Create
106app = client.spectrum.apps.create(
107    zone_id="your-zone-id",
108    protocol="tcp/22",
109    dns={"type": "CNAME", "name": "ssh.example.com"},
110    origin_direct=["tcp://192.0.2.1:22"],
111    ip_firewall=True,
112    tls="off",
113)
114 
115# List
116apps = client.spectrum.apps.list(zone_id="your-zone-id")
117 
118# Get
119app_details = client.spectrum.apps.get(zone_id="your-zone-id", app_id=app.id)
120 
121# Update
122client.spectrum.apps.update(zone_id="your-zone-id", app_id=app.id, tls="full")
123 
124# Delete
125client.spectrum.apps.delete(zone_id="your-zone-id", app_id=app.id)
126 
127# Analytics
128analytics = client.spectrum.analytics.aggregate(
129    zone_id="your-zone-id",
130    metrics=["bytesIngress", "bytesEgress"],
131    since=datetime.now() - timedelta(hours=1),
132)
133```
134 
135## Go SDK
136 
137```go
138import "github.com/cloudflare/cloudflare-go"
139 
140api, _ := cloudflare.NewWithAPIToken("your-api-token")
141 
142// Create
143app, _ := api.CreateSpectrumApplication(ctx, "zone-id", cloudflare.SpectrumApplication{
144    Protocol:         "tcp/22",
145    DNS:              cloudflare.SpectrumApplicationDNS{Type: "CNAME", Name: "ssh.example.com"},
146    OriginDirect:     []string{"tcp://192.0.2.1:22"},
147    IPFirewall:       true,
148    ArgoSmartRouting: true,
149})
150 
151// List
152apps, _ := api.SpectrumApplications(ctx, "zone-id")
153 
154// Delete
155_ = api.DeleteSpectrumApplication(ctx, "zone-id", app.ID)
156```
157 
158## Analytics API
159 
160**Metrics:**
161- `bytesIngress` - Bytes received from clients
162- `bytesEgress` - Bytes sent to clients
163- `count` - Number of connections
164- `duration` - Connection duration (seconds)
165 
166**Dimensions:**
167- `event` - Connection event type
168- `appID` - Spectrum application ID
169- `coloName` - Datacenter name
170- `ipVersion` - IPv4 or IPv6
171 
172**Example:**
173```bash
174curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/analytics/aggregate/current?metrics=bytesIngress,bytesEgress,count&dimensions=appID" \
175  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
176```
177 
178## See Also
179 
180- [configuration.md](configuration.md) - Terraform/Pulumi
181- [patterns.md](patterns.md) - Protocol examples
182