وثائق بروكسي API، أتمتة الطلبات ومعلومات الاتصال
واجهة برمجة تطبيقات SMMProxy توفر رصيد، أسعار، طلبات بروكسي، وقوائم معلومات اتصال عبر HTTPS REST. أنشئ مفتاحًا في قائمة API في لوحة التحكم وأرسله في رأس Authorization كـ Bearer.
البدء
- قم بإنشاء حساب وإكمال أول عملية شحن. يمكن إنشاء مفتاح API فقط من حساب تمت عملية شحن واحدة عليه.
- قم بإنشاء مفتاح جديد من قائمة مفاتيح API في لوحة التحكم. سيتم عرض المفتاح مرة واحدة فقط عند إنشائه، لذا احفظه على الفور.
- قم بتضمين مفتاح 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": "..." }] }قيمة الطلب
| الاسم | التنسيق | الوصف |
|---|---|---|
| product | string | isp, mobile, ipv4, residential |
| country | string | رمز البلد المكون من حرفين صغير (us, gb, de ...) |
| quantity | integer | عدد IP·المنافذ، السكنية بوحدة GB |
| period | string | 1w 2w 1m 2m 3m 6m 9m 12m (لا يشمل السكني) |
| protocol | string | http أو socks5، افتراضيًا http (يتم إصدار كلا المنفذين) |
خطأ
| HTTP | error | معنى |
|---|---|---|
| 401 | unauthorized | المفتاح غير موجود أو غير صحيح. لن يتم خصم المال. |
| 400 | invalid_request | يرجى التحقق مرة أخرى من قيم المنتج، الدولة، الكمية، والمدة. لن يتم خصم المال. |
| 402 | insufficient_balance | الرصيد أقل من مبلغ الدفع. يرجى الشحن ثم إعادة الإرسال. لن يتم خصم المال. |
| 503 | network_error | حدث خطأ في الشبكة أثناء إرسال الطلب. لن يتم خصم المال ويمكنك إعادة الإرسال بعد قليل. |
| 429 | rate_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);