Разработчикам

Создавайте на API s4m

Всё в s4m — это REST API, тот же, что использует кабинет и мобильное приложение. Автоматизируйте аккаунты, выдавайте доступ к VPN/прокси и запрашивайте каталог бесплатных прокси.

Получить API-токенПосмотреть эндпоинты
Начало работы

Базовый URL и аутентификация

Все запросы идут на версионированный базовый URL по HTTPS. Аутентифицируйтесь, отправляя токен сессии в заголовке Bearer — получите его из /auth/login или /auth/token.

  • Тела запросов и ответов в JSON
  • Аутентификация токеном Bearer (сессионный JWT HS256)
  • Ограничение частоты; будьте вежливы
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":"[email protected]","password":"…"}' | jq -r .session)

curl https://s4m.online/v1/me -H "Authorization: Bearer $TOKEN"
Справочник

Эндпоинты

Аутентификация

POST/v1/auth/registerСоздать аккаунт с email + паролем. Возвращает токен сессии.
POST/v1/auth/loginОбменять email + пароль на токен сессии.
POST/v1/auth/anonymousСоздать анонимный аккаунт и токен — email не нужен.
POST/v1/auth/tokenОбменять токен аккаунта на новый токен сессии.

Аккаунт

GET/v1/meТекущий аккаунт: email, роль, статус, кошелёк, пул трафика и пакет PAYG.
GET/v1/me/usageТекущее использование против лимитов вашего плана.
GET/v1/me/usage/seriesЕжедневные байты вверх/вниз за последние 30 дней.
POST/v1/me/subscribeАктивируйте тариф (оплата через оформление или ваучер).
GET/v1/me/packБаланс предоплаченного трафика PAYG (остаток байтов).
POST/v1/me/redeemАктивировать ваучер — кошелёк, пул трафика, пакет или дни тарифа.

Доступ (VPN и прокси)

POST/v1/me/accessВыдать доступ: возвращает учётные данные прокси + конфиг WireGuard.
GET/v1/me/accessСписок ваших активных учётных данных прокси и пиров WireGuard.
POST/v1/me/split-tunnelСформировать AllowedIPs для WireGuard и PAC-файл, чтобы через туннель шли только выбранные адреса.

Рефералы, приватность и вебхуки

GET/v1/me/referralВаш реферальный код, ссылка и статистика заработанных бонусов.
POST/v1/me/referral/claimЗафиксировать, что вас пригласили по реферальному коду (бонус при подписке).
GET/v1/me/privacyЖивая сводка того, что именно мы храним о вашем аккаунте.
GET/v1/me/exportСкачать все данные аккаунта в JSON (переносимость по GDPR).
DELETE/v1/meУдалить аккаунт: отозвать доступы, отменить подписки, стереть персональные данные.
POST/v1/me/webhooksЗарегистрировать вебхук с подписью HMAC для событий аккаунта.
GET/v1/me/webhooksСписок ваших вебхуков и количество доставок.
DELETE/v1/me/webhooks/{id}Удалить вебхук.

Каталог бесплатных прокси

GET/v1/proxiesЗапрос живого списка бесплатных прокси (фильтр по стране, протоколу, анонимности).
GET/v1/proxies/facetsДоступные фасеты фильтров с подсчётом.
GET/v1/proxies/feedСвежий проверенный фид — format=json|txt|csv, пагинация через limit (1–1000) и offset, сортировка.

Инструменты

GET/v1/ipВернуть публичный IP запрашивающего (what-is-my-ip).
POST/v1/proxy-checkПроверить прокси через фиксированный echo: живой, задержка, выходной IP, анонимность.
GET/v1/lookup/{ip}Threat-intel: является ли этот IP известным/живым открытым прокси или выходом s4m? Возвращает оценку риска.
Примеры

Готовые рецепты

Выдать доступ к прокси + 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 }

Запрос списка бесплатных прокси

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

Листать весь фид

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'

Проверить, работает ли прокси

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 }

Получить статистику за 30 дней

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

Ответы на вопросы

Стабилен ли / версионирован API?

Да — эндпоинты под /v1. Несовместимые изменения выходят под новым префиксом версии.

Как аутентифицировать мобильное приложение?

Так же: получите токен сессии из /auth/login или анонимный токен, затем отправляйте его в заголовке Bearer.

Какие ограничения частоты?

Аутентификация и чувствительные эндпоинты имеют лимит частоты на IP. Делайте паузу при 429 и храните токены на сервере.

Могу ли я автоматизировать выдачу доступа для своих пользователей?

Да — реселлеры создают суб-пользователей с индивидуальными квотами через API аккаунта, затем выдают доступ программно.

Разрабатывайте быстрее на s4m

Анонимные аккаунты — возьмите токен и начинайте создавать.

Получить API-токен

Эту страницу нашли по запросу

Реальные поисковые фразы, на которые отвечает эта страница — по ссылкам откроются материалы, раскрывающие тему глубже.