Desarrolladores

Construye sobre la API s4m

Todo en s4m es una API REST — la misma que utiliza el panel y la aplicación móvil. Automatiza cuentas, emite acceso a VPN/proxy y consulta el catálogo de proxies gratuitos.

Obtén un token de API Navegar por puntos finales

Comenzando

URL base y autenticación

Todas las solicitudes van a la URL base versionada a través de HTTPS. Autentícate enviando tu token de sesión como un encabezado Bearer — obtén uno de /auth/login o /auth/token.

Cuerpos de solicitud y respuesta JSON
Autenticación con token Bearer (JWT de sesión HS256)
Limitado por tasa; sé un buen ciudadano

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"

Referencia

Puntos finales

Autenticación

POST	/v1/auth/register	Crea una cuenta con correo electrónico + contraseña. Devuelve un token de sesión.
POST	/v1/auth/login	Intercambia correo electrónico + contraseña por un token de sesión.
POST	/v1/auth/anonymous	Crea una cuenta y un token anónimos — no se requiere correo electrónico.
POST	/v1/auth/token	Intercambia un token de cuenta por un token de sesión nuevo.

Cuenta

GET	/v1/me	La cuenta actual: correo electrónico, rol, estado, billetera, grupo de tráfico y paquete PAYG.
GET	/v1/me/usage	Uso actual vs los límites de tu plan.
GET	/v1/me/usage/series	Bytes diarios de subida/bajada durante los últimos 30 días.
POST	/v1/me/subscribe	Activar un plan (pagado a través de la compra o un vale).
GET	/v1/me/pack	Tu saldo de tráfico PAYG prepago (bytes restantes).
POST	/v1/me/redeem	Canjea un código de voucher — billetera, grupo de tráfico, paquete o días de plan.

Acceso (VPN y proxy)

POST	/v1/me/access	Acceso a la emisión: devuelve credenciales de proxy + una configuración de WireGuard.
GET	/v1/me/access	Enumera tus credenciales de proxy activas y pares de WireGuard.
POST	/v1/me/split-tunnel	Construye WireGuard AllowedIPs + un archivo PAC para enrutar solo destinos elegidos.

Referencias, privacidad y webhooks

GET	/v1/me/referral	Tu código de referencia, enlace y estadísticas de bonificación ganada.
POST	/v1/me/referral/claim	Registrar que un código de referencia te refirió (bono al suscribirse).
GET	/v1/me/privacy	Un resumen en vivo de exactamente lo que almacenamos sobre su cuenta.
GET	/v1/me/export	Descarga todos los datos de tu cuenta como JSON (portabilidad GDPR).
DELETE	/v1/me	Borra tu cuenta: revoca acceso, cancela suscripciones, elimina datos personales.
POST	/v1/me/webhooks	Registra un webhook firmado con HMAC para eventos de cuenta.
GET	/v1/me/webhooks	Enumera tus webhooks y sus conteos de entrega.
DELETE	/v1/me/webhooks/{id}	Eliminar un webhook.

Catálogo de proxies gratuitos

GET	/v1/proxies	Consulta la lista de proxies gratuitos en vivo (filtra por país, protocolo, anonimato).
GET	/v1/proxies/facets	Facetas de filtro disponibles con conteos.
GET	/v1/proxies/feed	Fuente validada fresca — formato=json\|txt\|csv, paginada con límite (1–1000) y desplazamiento, ordenable.

Herramientas

GET	/v1/ip	Eco la IP pública del llamador (cuál-es-mi-ip).
POST	/v1/proxy-check	Prueba un proxy a través de un eco fijo: activo, latencia, IP de salida, anonimato.
GET	/v1/lookup/{ip}	Inteligencia de amenazas: ¿es esta IP un proxy abierto conocido/en vivo o una salida s4m? Devuelve un puntaje de riesgo.

Ejemplos

Recetas para copiar y pegar

Emitir acceso a 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 }

Consulta la lista de proxies gratuitos

bash

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

Pasa por todo el 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'

Verifica si un proxy funciona

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 }

Extrae tu uso de 30 días

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

Preguntas, respondidas

¿Es la API estable / versionada?

Sí — los puntos finales viven bajo /v1. Los cambios importantes se envían bajo un nuevo prefijo de versión.

¿Cómo autentico la aplicación móvil?

De la misma manera: obtén un token de sesión de /auth/login o un token anónimo, luego envíalo como un encabezado Bearer.

¿Cuáles son los límites de tasa?

Los puntos finales de autenticación y sensibles tienen un límite de tasa por IP. Retrocede en 429 y mantén los tokens del lado del servidor.

¿Puedo automatizar la provisión para mis usuarios?

Sí, los revendedores crean subusuarios con cuotas por usuario a través de la API de la cuenta, y luego emiten acceso programáticamente.

Envía más rápido en s4m

Cuentas anónimas — obtén un token y comienza a construir.

Obtén un token de API

Las personas encontraron esta página buscando

s4m API — API REST de VPN y proxy para desarrolladores
servidor vpn privado para windows
servidor vpn privado suscripción
WireGuard VPN
cómo configurar openvpn
cómo configurar vpn wireguard
planes y precios
lista de proxies gratuitos por país
barato openvpn
lista de proxies gratuita
barato vpn
proxies SOCKS5 y HTTP
lista de proxies gratuitos comparación
gratuito proxy anónimo
comprar ip dedicada

Frases de búsqueda reales que esta página responde — los enlaces abren la página que las cubre en profundidad.