Desenvolvedores

Construa na API s4m

Tudo em s4m é uma API REST — a mesma que o painel e o aplicativo móvel usam. Automatize contas, emita acesso VPN/proxy e consulte o catálogo de proxies gratuitos.

Obtenha um token de API Navegar por endpoints

Começando

URL base e autenticação

Todas as solicitações vão para a URL base versionada via HTTPS. Autentique-se enviando seu token de sessão como um cabeçalho Bearer — obtenha um em /auth/login ou /auth/token.

Corpos de solicitação e resposta JSON
Autenticação por token Bearer (JWT de sessão HS256)
Limitado por taxa; seja um bom cidadão

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"

Referência

Pontos finais

Autenticação

POST	/v1/auth/register	Crie uma conta com e-mail + senha. Retorna um token de sessão.
POST	/v1/auth/login	Troque e-mail + senha por um token de sessão.
POST	/v1/auth/anonymous	Crie uma conta e token anônimos — sem necessidade de e-mail.
POST	/v1/auth/token	Troque um token de conta por um token de sessão novo.

Conta

GET	/v1/me	A conta atual: e-mail, função, status, carteira, pool de tráfego e pacote PAYG.
GET	/v1/me/usage	Uso atual vs limites do seu plano.
GET	/v1/me/usage/series	Bytes diários de upload/download dos últimos 30 dias.
POST	/v1/me/subscribe	Ative um plano (pago via checkout ou voucher).
GET	/v1/me/pack	Seu saldo de tráfego PAYG pré-pago (bytes restantes).
POST	/v1/me/redeem	Resgatar um código de voucher — carteira, pool de tráfego, pacote ou dias de plano.

Acesso (VPN e proxy)

POST	/v1/me/access	Acesso à emissão: retorna credenciais de proxy + uma configuração WireGuard.
GET	/v1/me/access	Liste suas credenciais de proxy ativas e pares WireGuard.
POST	/v1/me/split-tunnel	Construa AllowedIPs do WireGuard + um arquivo PAC para rotear apenas destinos escolhidos.

Referências, privacidade & webhooks

GET	/v1/me/referral	Seu código de referência, link e estatísticas de bônus ganhos.
POST	/v1/me/referral/claim	Registre que um código de referência o indicou (bônus ao se inscrever).
GET	/v1/me/privacy	Um resumo ao vivo de exatamente o que armazenamos sobre sua conta.
GET	/v1/me/export	Baixe todos os dados da sua conta como JSON (portabilidade GDPR).
DELETE	/v1/me	Apague sua conta: revogue acesso, cancele assinaturas, limpe dados pessoais.
POST	/v1/me/webhooks	Registre um webhook assinado com HMAC para eventos de conta.
GET	/v1/me/webhooks	Liste seus webhooks e suas contagens de entrega.
DELETE	/v1/me/webhooks/{id}	Excluir um webhook.

Catálogo de proxies gratuitos

GET	/v1/proxies	Consulte a lista de proxies gratuitos ao vivo (filtre por país, protocolo, anonimato).
GET	/v1/proxies/facets	Facetas de filtro disponíveis com contagens.
GET	/v1/proxies/feed	Feed validado fresco — formato=json\|txt\|csv, paginado com limite (1–1000) e offset, classificável.

Ferramentas

GET	/v1/ip	Ecoar o IP público do chamador (qual é meu IP).
POST	/v1/proxy-check	Teste um proxy através de um eco fixo: ativo, latência, IP de saída, anonimato.
GET	/v1/lookup/{ip}	Inteligência de ameaça: este IP é um proxy aberto conhecido/vivo ou uma saída s4m? Retorna uma pontuação de risco.

Exemplos

Receitas para copiar e colar

Emitir acesso 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 }

Consultar a 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'

Navegar por todo o 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'

Verifique se um 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 }

Puxe seu uso de 30 dias

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

Perguntas, respondidas

A API é estável / versionada?

Sim — os endpoints vivem sob /v1. Mudanças significativas são lançadas sob um novo prefixo de versão.

Como faço para autenticar o aplicativo móvel?

Da mesma forma: obtenha um token de sessão de /auth/login ou um token anônimo, e então envie-o como um cabeçalho Bearer.

Quais são os limites de taxa?

Endpoints de autenticação e sensíveis têm limite de taxa por IP. Reduza a velocidade em 429 e mantenha os tokens no lado do servidor.

Posso automatizar o provisionamento para meus usuários?

Sim — revendedores criam sub-usuários com cotas por usuário via API de conta, e depois emitem acesso programaticamente.

Envie mais rápido no s4m

Contas anônimas — pegue um token e comece a construir.

Obtenha um token de API

As pessoas encontraram esta página pesquisando por

s4m API — API REST de VPN e proxy para desenvolvedores
servidor vpn privado para windows
servidor vpn privado assinatura
WireGuard VPN
como configurar openvpn
como configurar vpn wireguard
planos e preços
lista de proxies gratuitos por país
barato openvpn
lista de proxies gratuita
barato vpn
proxies SOCKS5 e HTTP
lista de proxies gratuitos comparação
grátis proxy anônimo
comprar ip dedicado

Frases de busca reais que esta página responde — os links abrem a página que as cobre em profundidade.