דף הבית / למפתחים / Orders API

Orders API

אפשר להוסיף את smm.guide לפאנל שלך כספק. כל מסלול שבונים בחשבון הוא שירות עם מזהה משלו: הפאנל שלך שולח הזמנה למזהה הזה, והמסלול מעביר אותה לראשון מבין הספקים שלך שיכול לקבל אותה.

שלושה שלבים

הפורמט הוא זה שפאנלי SMM כבר משתמשים בו ביניהם, כך שאין מה לתכנת.

1בניית מסלולחשבון, Orders desk, מסלולים. בוחרים מה הוא מספק ומוסיפים עד חמישה שירותים מהסוג הזה מהפאנלים שחיברת.
2יצירת המפתחOrders desk,‏ Orders API. המפתח מוצג פעם אחת. אפשר להגביל אותו לכתובת השרת של הפאנל שלך.
3הוספת ספק בפאנל שלךכתובת API https://smm.guide/api/v2 ואת המפתח. אחר כך מייבאים את השירותים: המסלולים שלך מגיעים עם המזהים, המחירים והמגבלות שלהם.

פורמט הבקשה

שיטת HTTPPOST
כתובת APIhttps://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 שלך
actionservices

תשובה

[
  {
    "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 שלך
actionadd
serviceמזהה המסלול, שמונה ספרות
linkקישור לדף, לפוסט או לפרופיל
quantityהכמות הנדרשת

תשובה

{
  "order": 23501
}

אף אחד לא קיבל אותה

{
  "error": "No step of this route accepted the order. …"
}

מספר ההזמנה נשאר זהה לכל אורך חיי ההזמנה, לא משנה איזה ספק מספק אותה בסוף. מסלול מקבל קישור וכמות; הזנה הדרגתית, תגובות ושדות נוספים אחרים נדחים.

סטטוס הזמנה

פרמטרתיאור
keyמפתח ה-API שלך
actionstatus
orderמזהה הזמנה

תשובה

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
פרמטרתיאור
keyמפתח ה-API שלך
actionstatus
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 שלך
actionbalance

תשובה

{
  "balance": "126.1375",
  "currency": "USD"
}

ביטול

מועבר לספק שמחזיק כרגע בהזמנה, אם השירות שלו מציע ביטול. הזמנה שבוטלה על ידך אף פעם לא נשלחת לשלב הבא.

פרמטרתיאור
keyמפתח ה-API שלך
actioncancel
ordersמזהי הזמנות מופרדים בפסיק, עד 100

תשובה

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

מילוי חוזר

מועבר לספק שסיפק את ההזמנה. המילוי החוזר נושא את המספר של ההזמנה עצמה.

פרמטרתיאור
keyמפתח ה-API שלך
actionrefill
orderמזהה הזמנה. או orders: כמה מזהים, מופרדים בפסיק

תשובה, הזמנה אחת

{ "refill": "23501" }

תשובה, כמה הזמנות

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
פרמטרתיאור
keyמפתח ה-API שלך
actionrefill_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.