Розробникам

Створюйте на 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-токен

Цю сторінку знаходять за запитами

Реальні пошукові фрази, на які відповідає ця сторінка — за посиланнями відкриються матеріали, що розкривають тему глибше.