Développeurs

Construisez sur l'API s4m

Tout dans s4m est une API REST — la même que celle utilisée par le tableau de bord et l'application mobile. Automatisez les comptes, émettez des accès VPN/proxy et interrogez le catalogue de proxies gratuits.

Obtenez un jeton API Parcourir les points de terminaison

Commencer

URL de base et authentification

Toutes les requêtes vont à l'URL de base versionnée via HTTPS. Authentifiez-vous en envoyant votre jeton de session en tant qu'en-tête Bearer — obtenez-en un depuis /auth/login ou /auth/token.

Corps de requête et de réponse JSON
Authentification par jeton Bearer (JWT de session HS256)
Limité en taux ; soyez un bon citoyen

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"

Référence

Points de terminaison

Authentification

POST	/v1/auth/register	Créez un compte avec email + mot de passe. Renvoie un jeton de session.
POST	/v1/auth/login	Échangez l'email + le mot de passe contre un jeton de session.
POST	/v1/auth/anonymous	Créez un compte et un jeton anonymes — aucun e-mail requis.
POST	/v1/auth/token	Échangez un jeton de compte contre un nouveau jeton de session.

Compte

GET	/v1/me	Le compte actuel : email, rôle, statut, portefeuille, pool de trafic et pack PAYG.
GET	/v1/me/usage	Utilisation actuelle par rapport aux limites de votre plan.
GET	/v1/me/usage/series	Octets montants/descendants quotidiens pour les 30 derniers jours.
POST	/v1/me/subscribe	Activez un plan (payé via le paiement ou un bon).
GET	/v1/me/pack	Votre solde de trafic PAYG prépayé (octets restants).
POST	/v1/me/redeem	Échangez un code de bon — portefeuille, pool de trafic, pack ou jours de plan.

Accès (VPN et proxy)

POST	/v1/me/access	Accès à l'émission : renvoie les identifiants de proxy + une configuration WireGuard.
GET	/v1/me/access	Listez vos identifiants de proxy actifs et vos pairs WireGuard.
POST	/v1/me/split-tunnel	Construisez WireGuard AllowedIPs + un fichier PAC pour router uniquement les destinations choisies.

Références, confidentialité & webhooks

GET	/v1/me/referral	Votre code de parrainage, lien et statistiques de bonus gagnés.
POST	/v1/me/referral/claim	Enregistrez qu'un code de parrainage vous a référé (bonus à l'abonnement).
GET	/v1/me/privacy	Un résumé en direct de ce que nous stockons exactement sur votre compte.
GET	/v1/me/export	Téléchargez toutes vos données de compte au format JSON (portabilité GDPR).
DELETE	/v1/me	Effacez votre compte : révoquez l'accès, annulez les abonnements, nettoyez les données personnelles.
POST	/v1/me/webhooks	Enregistrez un webhook signé HMAC pour les événements de compte.
GET	/v1/me/webhooks	Listez vos webhooks et leurs comptes de livraison.
DELETE	/v1/me/webhooks/{id}	Supprimer un webhook.

Catalogue de proxys gratuits

GET	/v1/proxies	Interrogez la liste de proxy gratuite en direct (filtre par pays, protocole, anonymat).
GET	/v1/proxies/facets	Facettes de filtre disponibles avec des comptes.
GET	/v1/proxies/feed	Flux validé frais — format=json\|txt\|csv, paginé avec limite (1–1000) et décalage, triable.

Outils

GET	/v1/ip	Écho de l'IP publique de l'appelant (quelle est mon IP).
POST	/v1/proxy-check	Testez un proxy à travers un écho fixe : actif, latence, IP de sortie, anonymat.
GET	/v1/lookup/{ip}	Renseignement sur les menaces : cette IP est-elle un proxy ouvert connu/en direct ou une sortie s4m ? Renvoie un score de risque.

Exemples

Recettes à copier-coller

Problème d'accès 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 }

Interroger la liste des proxy gratuits

bash

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

Parcourez tout le fil

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'

Vérifiez si un proxy fonctionne

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 }

Tirez votre utilisation sur 30 jours

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

Questions, réponses

L'API est-elle stable / versionnée ?

Oui — les points de terminaison vivent sous /v1. Les changements majeurs sont expédiés sous un nouveau préfixe de version.

Comment authentifier l'application mobile ?

De la même manière : obtenez un jeton de session depuis /auth/login ou un jeton anonyme, puis envoyez-le en tant qu'en-tête Bearer.

Quelles sont les limites de taux ?

Les points de terminaison d'authentification et sensibles sont limités par taux par IP. Réduisez la vitesse en cas de 429 et gardez les jetons côté serveur.

Puis-je automatiser le provisionnement pour mes utilisateurs ?

Oui — les revendeurs créent des sous-utilisateurs avec des quotas par utilisateur via l'API de compte, puis émettent l'accès de manière programmatique.

Expédiez plus rapidement sur s4m

Comptes anonymes — récupérez un jeton et commencez à construire.

Obtenez un jeton API

Les gens ont trouvé cette page en recherchant

s4m API — API REST VPN & proxy pour les développeurs
serveur vpn privé pour windows
serveur vpn privé abonnement
VPN WireGuard
comment configurer openvpn
comment configurer vpn wireguard
plans et tarifs
liste de proxies gratuits par pays
pas cher openvpn
liste de proxies gratuite
pas cher vpn
proxys SOCKS5 et HTTP
liste de proxies gratuits comparaison
gratuit proxy anonyme
acheter ip dédiée

Vraies phrases de recherche auxquelles cette page répond — les liens ouvrent la page qui les couvre en profondeur.