डेवलपर्स

s4m API पर निर्माण करें

s4m में सब कुछ एक REST API है - वही जो डैशबोर्ड और मोबाइल ऐप उपयोग करते हैं। खातों को स्वचालित करें, VPN/प्रॉक्सी एक्सेस जारी करें, और मुफ्त-प्रॉक्सी कैटलॉग को क्वेरी करें।

एक API टोकन प्राप्त करेंएंडपॉइंट ब्राउज़ करें
शुरू करना

बेस URL और प्रमाणीकरण

सभी अनुरोध HTTPS के माध्यम से संस्करणित बेस URL पर जाते हैं। अपने सत्र टोकन को एक बियरर हेडर के रूप में भेजकर प्रमाणीकरण करें — एक /auth/login या /auth/token से प्राप्त करें।

  • JSON अनुरोध और प्रतिक्रिया निकाय
  • बियरर टोकन प्रमाणीकरण (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वर्तमान खाता: ईमेल, भूमिका, स्थिति, वॉलेट, ट्रैफ़िक पूल और 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केवल चुने हुए गंतव्यों को रूट करने के लिए 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-हस्ताक्षरित वेबहुक पंजीकृत करें।
GET/v1/me/webhooksअपने वेबहुक्स और उनके डिलीवरी की गिनती सूचीबद्ध करें।
DELETE/v1/me/webhooks/{id}एक वेबहुक हटाएँ।

फ्री-प्रॉक्सी कैटलॉग

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एक निश्चित इको के माध्यम से प्रॉक्सी का परीक्षण करें: जीवित, विलंबता, निकासी आईपी, गुमनामी।
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 से एक सत्र टोकन प्राप्त करें या एक गुमनाम टोकन, फिर इसे एक बियरर हेडर के रूप में भेजें।

रेट लिमिट क्या हैं?

प्रमाणन और संवेदनशील एंडपॉइंट्स प्रति IP दर-सीमित हैं। 429 पर पीछे हटें और टोकन को सर्वर-साइड पर रखें।

क्या मैं अपने उपयोगकर्ताओं के लिए प्रोविजनिंग को स्वचालित कर सकता हूँ?

हाँ - पुनर्विक्रेता खाता API के माध्यम से प्रति-उपयोगकर्ता कोटा के साथ उप-उपयोगकर्ताओं का निर्माण करते हैं, फिर प्रोग्रामेटिक रूप से पहुंच जारी करते हैं।

s4m पर तेजी से शिप करें

गोपनीय खाते — एक टोकन प्राप्त करें और निर्माण शुरू करें।

एक API टोकन प्राप्त करें

लोगों ने इस पृष्ठ को खोजकर पाया

वास्तविक खोज वाक्यांश जिनका यह पृष्ठ उत्तर देता है — लिंक किए गए वाक्यांश उस पृष्ठ को खोलते हैं जो उन्हें गहराई से कवर करता है।