HTTP API

# Display your current token
surge token

import requests
import time

class SurgeClient:
    def __init__(self, host="http://localhost:1700", token=None):
        self.host = host.rstrip('/')
        self.token = token
    
    def _headers(self):
        headers = {"Content-Type": "application/json"}
        if self.token:
            headers["Authorization"] = f"Bearer {self.token}"
        return headers
    
    def add_download(self, url, mirrors=None, path=None):
        data = {"url": url}
        if mirrors:
            data["mirrors"] = mirrors
        if path:
            data["path"] = path
        
        response = requests.post(
            f"{self.host}/download",
            headers=self._headers(),
            json=data
        )
        return response.json()
    
    def list_downloads(self):
        response = requests.get(
            f"{self.host}/list",
            headers=self._headers()
        )
        return response.json()
    
    def pause(self, download_id):
        response = requests.post(
            f"{self.host}/pause?id={download_id}",
            headers=self._headers()
        )
        return response.json()
    
    def resume(self, download_id):
        response = requests.post(
            f"{self.host}/resume?id={download_id}",
            headers=self._headers()
        )
        return response.json()

# Usage
client = SurgeClient(token="your-token")

# Add download
client.add_download("https://example.com/file.zip")

# Monitor progress
while True:
    downloads = client.list_downloads()
    active = [d for d in downloads if d['status'] == 'downloading']
    
    if not active:
        break
    
    for d in active:
        print(f"{d['filename']}: {d['progress']:.1f}% @ {d['speed']:.1f} MB/s")
    
    time.sleep(2)

const express = require('express');
const axios = require('axios');

const app = express();
const SURGE_API = 'http://localhost:1700';
const SURGE_TOKEN = 'your-token';

const headers = {
  'Authorization': `Bearer ${SURGE_TOKEN}`,
  'Content-Type': 'application/json'
};

// Add download endpoint
app.post('/api/download', async (req, res) => {
  try {
    const response = await axios.post(
      `${SURGE_API}/download`,
      req.body,
      { headers }
    );
    res.json(response.data);
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});

// List downloads endpoint
app.get('/api/downloads', async (req, res) => {
  try {
    const response = await axios.get(
      `${SURGE_API}/list`,
      { headers }
    );
    res.json(response.data);
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});

app.listen(3000, () => {
  console.log('Dashboard running on http://localhost:3000');
});