Orders API
أضف smm.guide إلى لوحتك كمزوّد. كل مسار تنشئه في حسابك خدمة لها معرّفها الخاص: ترسل لوحتك الطلب إلى هذا المعرّف، ويمرّره المسار إلى أول مزوّد من مزوّديك يمكنه استلامه.
ثلاث خطوات
الصيغة هي نفسها التي تستخدمها لوحات SMM فيما بينها، لذا لا حاجة إلى أي برمجة.
https://smm.guide/api/v2 والمفتاح. استورد الخدمات: تصل مساراتك بمعرّفاتها وأسعارها وحدودها.صيغة الطلب
| طريقة HTTP | POST |
| عنوان API | https://smm.guide/api/v2 |
| جسم الطلب | application/x-www-form-urlencoded، أو JSON مع Content-Type: application/json. A multipart/form-data يُقرأ جسم الطلب بهذه الصيغة أيضًا، وهو ما يرسله PHP عندما تُمرَّر مصفوفة إلى cURL |
| الاستجابة | JSON، دائمًا مع HTTP 200، حتى لجسم طلب لا يمكننا قراءته أو لطلب كبير جدًا. الخطأ يكون {"error": "…"} |
| المال | الدولار الأمريكي. الأسعار لكل 1,000 |
قائمة الخدمات
مساراتك التي يمكنها استلام طلب الآن. المسار المعطّل، أو الذي خرجت كل خطواته، لا يظهر في القائمة.
| المعلمة | الوصف |
|---|---|
key | مفتاح API الخاص بك |
action | services |
الاستجابة
[
{
"service": 85725095,
"name": "TG views, main",
"type": "Default",
"category": "Telegram views",
"rate": "0.0018",
"min": "10",
"max": "1000000",
"refill": false,
"cancel": true,
"dripfeed": false
}
]rate هو أغلى خطوة في المسار قد تستلم طلبًا، بما فيها الخطوات المتخطّاة مؤقتًا (فاللوحة المتوقفة اليوم تعود غدًا)، لذا لا يكلّف الطلب أبدًا أكثر من السعر الذي استوردته لوحتك. min و max هي الأوسع التي تغطيها الخطوات العاملة مجتمعةً؛ والكمية التي تناسب بعضها فقط تذهب إلى إحداها. refill و cancel تكون true عندما توفرها كل خطوة من هذه الخطوات.
المسار المعطّل، أو الذي لا توجد فيه خطوة قادرة على العمل، يُستبعد من هذه القائمة حتى يعود. واللوحة التي تزامن خدماتها تلقائيًا ستعطّل تلك الخدمة من جانبها للمدة نفسها، وهذا ما تريده: فطلباتها كانت ستُرفض.
إضافة طلب
| المعلمة | الوصف |
|---|---|
key | مفتاح API الخاص بك |
action | add |
service | معرّف المسار، ثمانية أرقام |
link | رابط الصفحة أو المنشور أو الملف الشخصي |
quantity | الكمية المطلوبة |
الاستجابة
{
"order": 23501
}
لم يقبله أحد
{
"error": "No step of this route accepted the order. …"
}يبقى رقم الطلب كما هو طوال عمر الطلب، أيًّا كان المزوّد الذي ينفّذه في النهاية. يقبل المسار رابطًا وكمية؛ ويُرفض الإرسال التدريجي والتعليقات والحقول الإضافية الأخرى.
حالة الطلب
| المعلمة | الوصف |
|---|---|
key | مفتاح API الخاص بك |
action | status |
order | معرّف الطلب |
الاستجابة
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| المعلمة | الوصف |
|---|---|
key | مفتاح API الخاص بك |
action | status |
orders | معرّفات الطلبات مفصولة بفاصلة، حتى 100 |
الاستجابة
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| الحالة | المعنى |
|---|---|
Pending | قبله مزوّد ولم يبدأ بعد. وكذلك الطلب الذي لم يعطِ فيه المزوّد إجابة واضحة: يتوقف المسار عنده حتى تتحقق منه في حسابك. |
In progress, Processing | يُنفّذه مزوّد، أو أن الطلب في طريقه إلى الخطوة التالية. |
Completed | نُفّذ بالكامل. |
Partial | نُفّذ جزئيًا؛ remains هو ما لم يُنفَّذ. ويُحتسب ما نفّذته كل الخطوات: عندما تنفّذ خطوة جزءًا ويُلغى الباقي في الخطوة التالية، يكون الطلب Partial لا Canceled. ويقرر المزوّد إعادة باقي المبلغ. |
Canceled | لم يُنفَّذ شيء، ولم تستلم أي خطوة أخرى الطلب. charge يبيّن ما بقي مخصومًا، إن وُجد. |
charge هو ما خصمه المزوّدون مقابل هذا الطلب، بالدولار وفق سعر صرف يوم تقديمه. start_count يأتي من المزوّد الذي بدأه.
الرصيد
لا يحتفظ smm.guide بأي أموال لك. الرقم هو مجموع أرصدتك على اللوحات التي تقف وراء مساراتك، بالدولار.
| المعلمة | الوصف |
|---|---|
key | مفتاح API الخاص بك |
action | balance |
الاستجابة
{
"balance": "126.1375",
"currency": "USD"
}إلغاء
يُمرَّر إلى المزوّد الذي يحمل الطلب حاليًا، إذا كانت خدمته توفر الإلغاء. الطلب الذي تلغيه لا يُرسل أبدًا إلى الخطوة التالية.
| المعلمة | الوصف |
|---|---|
key | مفتاح API الخاص بك |
action | cancel |
orders | معرّفات الطلبات مفصولة بفاصلة، حتى 100 |
الاستجابة
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]إعادة التعبئة
يُمرَّر إلى المزوّد الذي نفّذ الطلب. تحمل إعادة التعبئة رقم الطلب نفسه.
| المعلمة | الوصف |
|---|---|
key | مفتاح API الخاص بك |
action | refill |
order | معرّف الطلب. أو orders: عدة معرّفات، مفصولة بفاصلة |
الاستجابة، طلب واحد
{ "refill": "23501" }
الاستجابة، عدة طلبات
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| المعلمة | الوصف |
|---|---|
key | مفتاح API الخاص بك |
action | refill_status |
refill | معرّف إعادة التعبئة. أو refills: عدة معرّفات، مفصولة بفاصلة |
الاستجابة
{ "status": "Completed" }ما يفعله المسار بالطلب
- تُجرَّب الخطوات بترتيبك، أو الأرخص من بين العاملة أولًا. أنت تختار ذلك في إعدادات المسار.
- تُتخطّى الخطوة عندما لا تستجيب لوحتها، أو لا يغطي رصيدها أو حدها اليومي الطلب، أو تكون الكمية خارج ما تقبله، أو يكون سعرها أعلى من الحد الذي وضعته، أو عندما يتجاوز الطلب بسعرها الحد اليومي للمسار نفسه. وتعود تلقائيًا.
- تخرج الخطوة عندما تخرج خدمتها من قائمة الأسعار، أو تبدأ اللوحة ببيع شيء آخر تحت المعرّف نفسه. تستمر الخطوات الأخرى في العمل، ونُبلغك بذلك.
- الرفض ينقل الطلب إلى الخطوة التالية. عندما تجيب اللوحة بالرفض، لا يُخصم شيء، فتُجرَّب الخطوة التالية.
- الإجابة غير الواضحة توقفه. انتهاء المهلة أو الإجابة المعطوبة لا يبيّنان ما إذا كان الطلب موجودًا. وإرساله إلى الخطوة التالية قد ينفّذه ويخصمه مرتين، لذا يتوقف المسار وتتحقق أنت من ذلك الطلب في حسابك.
- طلب نشط واحد لكل رابط. ما دام طلب لرابط ما قيد التنفيذ على مسار، يُرفض طلب ثانٍ للرابط نفسه، كما يفعل المزوّدون أنفسهم.
- يمكن أن ينتقل الإلغاء قبل التنفيذ إلى الخطوة التالية أيضًا، إذا فعّلت ذلك. وما تركه الطلب الجزئي دون تنفيذ لا ينتقل إلا إذا طلبت ذلك.
الأخطاء
| الخطأ | معناه |
|---|---|
Invalid API key | المفتاح خاطئ أو مستبدل أو مُبطَل. |
This key is limited to certain addresses… | جاء الطلب من عنوان غير موجود في قائمة المفتاح. |
Incorrect request | غير معروف action. |
Incorrect service ID | لا يوجد لديك مسار بهذا المعرّف. المسار المحذوف يحتفظ برقمه، ولا يُعطى لغيره أبدًا. |
Incorrect order ID | لا يوجد لديك طلب بهذا الرقم. |
Link is required, Quantity is required | أحد حقول add مفقود أو ليس رقمًا. |
A route takes a link and a quantity only | حمل الطلب إرسالًا تدريجيًا أو تعليقات أو حقلًا إضافيًا آخر. |
This route is switched off | فعّله في حسابك. |
This route already has an order for this link… | انتظر حتى ينتهي الطلب الجاري. |
No step of this route can take this order right now. … | تم تخطّي كل الخطوات قبل إرسال أي شيء. يذكر النص كل لوحة وسببها. |
No step of this route accepted the order. … | رفضت كل الخطوات التي سُئلت. لم يُخصم شيء. |
Too many requests… | تجاوزت الحد المذكور أدناه. انتظر دقيقة. |
أمثلة
cURL
curl https://smm.guide/api/v2 \ -d key=sgo_… \ -d action=add \ -d service=85725095 \ -d link=https://t.me/channel/123 \ -d quantity=1000
PHP
function smmguide(array $post) {
$ch = curl_init('https://smm.guide/api/v2');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query(
['key' => 'sgo_…'] + $post),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
]);
$out = json_decode(curl_exec($ch), true);
curl_close($ch);
return $out;
}
$order = smmguide(['action' => 'add',
'service' => 85725095,
'link' => 'https://t.me/channel/123',
'quantity' => 1000]);
طلب add يُجاب عليه دائمًا خلال 30 ثانية. قد يسأل المسار عدة مزوّدين واحدًا تلو الآخر؛ ويحصل كل منهم على ما تبقى من هذا الوقت، والمزوّد الذي لا يمكن انتظاره لا يُسأل أصلًا. إذا لم يُجب آخر من سُئل عند انتهاء الوقت، تحصل على رقم طلب بحالة Pending، ويتوقف المسار عنده حتى تُعرف الإجابة. معظم الطلبات يُجاب عليها في ثانية أو ثانيتين.
الحدود والأمان
- 300 استدعاءً في الدقيقة لكل مفتاح، منها 120 لتقديم الطلبات. حتى 100 من أرقام الطلبات في
statusاستدعاء. - يُعرض المفتاح مرة واحدة ويُحفظ كبصمة. لا أنت ولا نحن يمكننا قراءته مجددًا. استبداله يعطّل القديم فورًا.
- العناوين المسموح بها. أدرج عنوان خادم لوحتك في حسابك، فلا يعمل المفتاح من أي مكان آخر.
- معرّف المسار ليس سرًّا ولا يحتاج إلى أن يكون كذلك. لا يعمل إلا مع مفتاح الحساب الذي يملك المسار.
- حدودك تبقى سارية. يُطبَّق الحد اليومي لكل لوحة، والحد اليومي للمسار نفسه، وأكبر طلب فيه، على الطلبات الواردة عبر API تمامًا كما على الطلبات التي تقدّمها يدويًا.
- لا تمر الأموال أبدًا عبر smm.guide. يُدفع كل طلب من رصيدك على اللوحة التي تستلمه. ويبقى الاسترداد والنزاعات بينك وبين تلك اللوحة.
تريد قراءة الدليل بدلًا من ذلك؟
للوحات ودرجات Trust Score والأسعار الحية API خاص بها، وخادم MCP للمساعدين.