SMMProxy

وثائق بروكسي API، أتمتة الطلبات ومعلومات الاتصال

واجهة برمجة تطبيقات SMMProxy توفر رصيد، أسعار، طلبات بروكسي، وقوائم معلومات اتصال عبر HTTPS REST. أنشئ مفتاحًا في قائمة API في لوحة التحكم وأرسله في رأس Authorization كـ Bearer.

البدء

  1. قم بإنشاء حساب وإكمال أول عملية شحن. يمكن إنشاء مفتاح API فقط من حساب تمت عملية شحن واحدة عليه.
  2. قم بإنشاء مفتاح جديد من قائمة مفاتيح API في لوحة التحكم. سيتم عرض المفتاح مرة واحدة فقط عند إنشائه، لذا احفظه على الفور.
  3. قم بتضمين مفتاح Authorization: Bearer في كل طلب. الاستجابة تكون بتنسيق JSON وتحتوي دائمًا على حقل ok.

العنوان الأساسي: https://smmproxy.io/api/v1

curl -H "Authorization: Bearer smpk_YOUR_KEY" https://smmproxy.io/api/v1/balance

GET/api/v1/balance

استعلام عن الرصيد

مثال على الاستجابة
{ "ok": true, "balance": "48.20", "currency": "USD" }

GET/api/v1/products

استعلام عن المنتج، الدولة، والسعر

مثال على الاستجابة
{ "ok": true, "periods": ["1w","2w","1m","2m","3m","6m","9m","12m"],
  "products": [{ "product": "isp", "unit": "ip", "countries": [{ "country": "us", "monthly": "1.29" }] }] }

POST/api/v1/orders

طلب البروكسي (الدفع من الرصيد)

نص الطلب
{ "product": "isp", "country": "us", "quantity": 5, "period": "1m" }
مثال على الاستجابة
{ "ok": true, "order": { "id": "OR-7K2M-Q8XD4P", "product": "isp", "country": "us",
  "quantity": 5, "period": "1m", "total": "6.45", "expires_at": "2026-11-21T09:00:00.000Z" } }

GET/api/v1/orders

قائمة الطلبات (آخر 100 طلب)

مثال على الاستجابة
{ "ok": true, "orders": [{ "id": "OR-7K2M-Q8XD4P", "status": "active", "total": "6.45" }] }

GET/api/v1/proxies?order=OR-7K2M-Q8XD4P

قائمة معلومات الاتصال

مثال على الاستجابة
{ "ok": true, "proxies": [{ "host": "198.51.100.24", "http_port": 10842, "socks5_port": 20842,
  "username": "u7kq2m", "password": "Xc81pLq0Zr", "country": "us", "expires_at": "..." }] }

قيمة الطلب

الاسمالتنسيقالوصف
productstringisp, mobile, ipv4, residential
countrystringرمز البلد المكون من حرفين صغير (us, gb, de ...)
quantityintegerعدد IP·المنافذ، السكنية بوحدة GB
periodstring1w 2w 1m 2m 3m 6m 9m 12m (لا يشمل السكني)
protocolstringhttp أو socks5، افتراضيًا http (يتم إصدار كلا المنفذين)

خطأ

HTTPerrorمعنى
401unauthorizedالمفتاح غير موجود أو غير صحيح. لن يتم خصم المال.
400invalid_requestيرجى التحقق مرة أخرى من قيم المنتج، الدولة، الكمية، والمدة. لن يتم خصم المال.
402insufficient_balanceالرصيد أقل من مبلغ الدفع. يرجى الشحن ثم إعادة الإرسال. لن يتم خصم المال.
503network_errorحدث خطأ في الشبكة أثناء إرسال الطلب. لن يتم خصم المال ويمكنك إعادة الإرسال بعد قليل.
429rate_limitedيمكن إرسال ما يصل إلى 300 مرة في الدقيقة.

مثال Python

import requests

API = "https://smmproxy.io/api/v1"
H = {"Authorization": "Bearer smpk_YOUR_KEY"}

order = requests.post(f"{API}/orders", headers=H, json={
    "product": "isp", "country": "us", "quantity": 5, "period": "1m"}).json()
if order["ok"]:
    proxies = requests.get(f"{API}/proxies", headers=H, params={"order": order["order"]["id"]}).json()
    for p in proxies["proxies"]:
        print(f'{p["host"]}:{p["http_port"]}:{p["username"]}:{p["password"]}')

مثال Node.js

const API = "https://smmproxy.io/api/v1";
const H = { Authorization: "Bearer smpk_YOUR_KEY", "Content-Type": "application/json" };

const r = await fetch(API + "/orders", { method: "POST", headers: H,
  body: JSON.stringify({ product: "mobile", country: "gb", quantity: 1, period: "1m" }) });
const j = await r.json();
console.log(j.ok ? j.order.id : j.error);
وثائق بروكسي API، الرصيد، الأسعار، الطلبات، قائمة البروكسي | SMMProxy