开发者

基于s4m API构建

s4m中的一切都是REST API——与仪表板和移动应用使用的相同。自动化账户，发放VPN/代理访问，并查询免费代理目录。

获取API令牌浏览端点
开始使用

基本URL和身份验证

所有请求通过 HTTPS 发送到版本化的基础 URL。通过将会话令牌作为 Bearer 头发送进行身份验证 — 从 /auth/login 或 /auth/token 获取一个。

  • JSON 请求和响应主体
  • Bearer 令牌认证 (HS256 会话 JWT)
  • 速率限制；做个好公民
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"
参考

端点

身份验证

POST/v1/auth/register使用电子邮件 + 密码创建帐户。返回会话令牌。
POST/v1/auth/login用电子邮件 + 密码交换会话令牌。
POST/v1/auth/anonymous创建一个匿名账户和令牌 — 无需电子邮件。
POST/v1/auth/token用账户令牌交换一个新的会话令牌。

账户

GET/v1/me当前账户：电子邮件、角色、状态、钱包、流量池和按需包。
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构建 WireGuard AllowedIPs + 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 签名的 webhook。
GET/v1/me/webhooks列出您的网络钩子及其交付计数。
DELETE/v1/me/webhooks/{id}删除一个 webhook。

免费代理目录

GET/v1/proxies查询实时免费代理列表（按国家、协议、匿名性过滤）。
GET/v1/proxies/facets可用的过滤面和计数。
GET/v1/proxies/feed新鲜验证的源——格式=json|txt|csv，分页限制（1–1000）和偏移量，可排序。

工具

GET/v1/ip回显呼叫者的公共 IP（what-is-my-ip）。
POST/v1/proxy-check通过固定回声测试代理：存活、延迟、出口IP、匿名性。
GET/v1/lookup/{ip}威胁情报：这个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令牌

人们通过搜索找到此页面

此页面回答的真实搜索短语 — 链接的短语打开详细覆盖它们的页面。