Sviluppatori

Costruisci sull'API s4m

Tutto in s4m è un'API REST — la stessa che utilizza il dashboard e l'app mobile. Automatizza gli account, emetti accessi VPN/proxy e consulta il catalogo dei proxy gratuiti.

Ottieni un token APINaviga negli endpoint
Iniziare

URL di base e autenticazione

Tutte le richieste vanno all'URL di base versionato tramite HTTPS. Autenticati inviando il tuo token di sessione come intestazione Bearer — ottienilo da /auth/login o /auth/token.

  • Corpi di richiesta e risposta JSON
  • Autenticazione con token Bearer (JWT di sessione HS256)
  • Limitato in termini di velocità; sii un buon cittadino
bash
# Base URL
https://s4m.online/v1

# Authenticate, then send the token on every call
TOKEN=$(curl -s -X POST https://s4m.online/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","password":"…"}' | jq -r .session)

curl https://s4m.online/v1/me -H "Authorization: Bearer $TOKEN"
Riferimento

Punti finali

Autenticazione

POST/v1/auth/registerCrea un account con email + password. Restituisce un token di sessione.
POST/v1/auth/loginScambia email + password per un token di sessione.
POST/v1/auth/anonymousCrea un account e un token anonimi — nessuna email richiesta.
POST/v1/auth/tokenScambia un token account per un nuovo token sessione.

Account

GET/v1/meL'account corrente: email, ruolo, stato, portafoglio, pool di traffico e pacchetto PAYG.
GET/v1/me/usageUtilizzo attuale rispetto ai limiti del tuo piano.
GET/v1/me/usage/seriesByte giornalieri in entrata/uscita per gli ultimi 30 giorni.
POST/v1/me/subscribeAttiva un piano (pagato tramite checkout o voucher).
GET/v1/me/packIl tuo saldo traffico PAYG prepagato (byte rimanenti).
POST/v1/me/redeemRiscatta un codice voucher — portafoglio, pool di traffico, pacchetto o giorni di piano.

Accesso (VPN e proxy)

POST/v1/me/accessAccesso all'emissione: restituisce le credenziali del proxy + una configurazione WireGuard.
GET/v1/me/accessElenca le tue credenziali proxy attive e i peer di WireGuard.
POST/v1/me/split-tunnelCrea WireGuard AllowedIPs + un file PAC per instradare solo le destinazioni scelte.

Riferimenti, privacy e webhook

GET/v1/me/referralIl tuo codice di riferimento, link e statistiche bonus guadagnate.
POST/v1/me/referral/claimRegistra che un codice di riferimento ti ha riferito (bonus all'iscrizione).
GET/v1/me/privacyUn riepilogo live di esattamente cosa memorizziamo sul tuo account.
GET/v1/me/exportScarica tutti i dati del tuo account come JSON (portabilità GDPR).
DELETE/v1/meElimina il tuo account: revoca l'accesso, annulla gli abbonamenti, cancella i dati personali.
POST/v1/me/webhooksRegistrati per un webhook firmato HMAC per eventi dell'account.
GET/v1/me/webhooksElenca i tuoi webhook e i loro conteggi di consegna.
DELETE/v1/me/webhooks/{id}Elimina un webhook.

Catalogo proxy gratuiti

GET/v1/proxiesInterroga la lista proxy gratuita live (filtra per paese, protocollo, anonimato).
GET/v1/proxies/facetsFacette di filtro disponibili con conteggi.
GET/v1/proxies/feedFeed validato fresco — formato=json|txt|csv, paginato con limite (1–1000) e offset, ordinabile.

Strumenti

GET/v1/ipEchi l'IP pubblico del chiamante (what-is-my-ip).
POST/v1/proxy-checkTesta un proxy attraverso un'eco fissa: attivo, latenza, IP di uscita, anonimato.
GET/v1/lookup/{ip}Threat-intel: questo IP è un proxy aperto noto/vivo o un exit s4m? Restituisce un punteggio di rischio.
Esempi

Ricette da copiare e incollare

Problema di accesso proxy + VPN

bash
curl -s -X POST https://s4m.online/v1/me/access \
  -H "Authorization: Bearer $TOKEN"
# -> { proxy_username, proxy_password, proxy_socks, proxy_http, wg_config }

Interroga l'elenco dei proxy gratuiti

bash
# Elite SOCKS5 proxies in Germany, as JSON
curl -s 'https://s4m.online/v1/proxies?country=de&protocol=socks5&anonymity=elite'

Sfoglia l'intero feed

bash
# 500 per page, walk offsets; format=json|txt|csv
curl -s 'https://s4m.online/v1/proxies/feed?format=json&limit=500&offset=0'
curl -s 'https://s4m.online/v1/proxies/feed?format=json&limit=500&offset=500'

Controlla se un proxy funziona

bash
curl -s -X POST https://s4m.online/v1/proxy-check \
  -H 'Content-Type: application/json' \
  -d '{"host":"proxy.example.com","port":1080,"protocol":"socks5"}'
# -> { alive, latency_ms, exit_ip, anonymity }

Estrai il tuo utilizzo di 30 giorni

python
import requests
H = {"Authorization": f"Bearer {TOKEN}"}
r = requests.get("https://s4m.online/v1/me/usage/series", headers=H)
for d in r.json()["series"]:
    print(d["date"], d["total"])
FAQ

Domande, risposte

L'API è stabile / versionata?

Sì — gli endpoint vivono sotto /v1. Le modifiche significative vengono rilasciate sotto un nuovo prefisso di versione.

Come posso autenticare l'app mobile?

Nello stesso modo: ottieni un token di sessione da /auth/login o un token anonimo, quindi invialo come intestazione Bearer.

Quali sono i limiti di velocità?

Gli endpoint di autenticazione e sensibili sono limitati per IP. Fai attenzione al 429 e mantieni i token lato server.

Posso automatizzare il provisioning per i miei utenti?

Sì — i rivenditori creano sub-utenti con quote per utente tramite l'API dell'account, quindi rilasciano l'accesso in modo programmatico.

Spedisci più velocemente su s4m

Account anonimi — prendi un token e inizia a costruire.

Ottieni un token API

Le persone hanno trovato questa pagina cercando

  • s4m API — VPN & proxy REST API per sviluppatori
  • server vpn privato per windows
  • server vpn privato abbonamento
  • WireGuard VPN
  • come impostare openvpn
  • come configurare wireguard vpn
  • piani e prezzi
  • lista di proxy gratuiti per paese
  • economico openvpn
  • lista proxy gratuita
  • economico vpn
  • proxy SOCKS5 e HTTP
  • lista di proxy gratuiti confronto
  • gratuito proxy anonimo
  • acquista ip dedicato

Frasi di ricerca reali a cui questa pagina risponde — i collegamenti aprono la pagina che le tratta in dettaglio.