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 לעוזרי AI.