መነሻ / ለገንቢዎች / Orders API

Orders API

smm.guideን በፓነልዎ ውስጥ እንደ አቅራቢ ያክሉ። በመለያዎ ውስጥ የሚገነቡት እያንዳንዱ ራውት የራሱ ID ያለው አገልግሎት ነው: ፓነልዎ ትዕዛዝን ወደዚያ ID ይልካል፣ ራውቱም ትዕዛዙን ሊቀበሉት ከሚችሉ አቅራቢዎችዎ ወደ መጀመሪያው ያስተላልፋል።

ሦስት እርምጃዎች

ቅርጸቱ SMM ፓነሎች አስቀድመው እርስ በርሳቸው የሚጠቀሙበት ነው፤ ስለዚህ ፕሮግራም የሚደረግ ምንም ነገር የለም።

1ራውት ይገንቡመለያ፣ Orders desk፣ ራውቶች። ራውቱ የሚያደርሰውን ይምረጡና ካገናኟቸው ፓነሎች የዚያ ዓይነት እስከ አምስት አገልግሎቶችን ያክሉ።
2ቁልፉን ይፍጠሩOrders desk፣ Orders API። ቁልፉ የሚታየው አንድ ጊዜ ብቻ ነው። በፓነልዎ ሰርቨር አድራሻ ብቻ እንዲሠራ መገደብ ይችላሉ።
3በፓነልዎ ውስጥ አቅራቢ ያክሉ:API URL https://smm.guide/api/v2 እና ቁልፉ። አገልግሎቶቹን ያስመጡ: ራውቶችዎ ከIDዎቻቸው፣ ከዋጋዎቻቸውና ከገደቦቻቸው ጋር ይመጣሉ።

የጥያቄ ቅርጸት

HTTP ዘዴPOST
API URLhttps://smm.guide/api/v2
አካልapplication/x-www-form-urlencoded፣ ወይም JSON ከዚህ ጋር: Content-Type: application/json. A multipart/form-data አካልም ይነበባል፤ ይህም cURL array ሲሰጠው PHP የሚልከው ነው
ምላሽ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የራውቱ ID፣ ስምንት አኃዞች
linkወደ ገጹ፣ ልጥፉ ወይም መገለጫው የሚወስድ ሊንክ
quantityየሚያስፈልገው ብዛት

ምላሽ

{
  "order": 23501
}

ማንም አልተቀበለውም

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

በመጨረሻ የትኛውም አቅራቢ ቢያደርሰው የትዕዛዙ ቁጥር በትዕዛዙ የሕይወት ዘመን ሁሉ ያው ይቆያል። ራውት ሊንክና ብዛት ይቀበላል፤ ድሪፕ-ፊድ፣ አስተያየቶችና ሌሎች ተጨማሪ መስኮች ውድቅ ይደረጋሉ።

የትዕዛዝ ሁኔታ

መለኪያመግለጫ
keyየእርስዎ API ቁልፍ
actionstatus
orderየትዕዛዝ ID

ምላሽ

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
መለኪያመግለጫ
keyየእርስዎ API ቁልፍ
actionstatus
ordersበኮማ የተለዩ የትዕዛዝ IDዎች፣ እስከ 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በኮማ የተለዩ የትዕዛዝ IDዎች፣ እስከ 100

ምላሽ

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

ሪፊል

ትዕዛዙን ወዳደረሰው አቅራቢ ይተላለፋል። ሪፊሉ የትዕዛዙን የራሱን ቁጥር ይይዛል።

መለኪያመግለጫ
keyየእርስዎ API ቁልፍ
actionrefill
orderየትዕዛዝ ID። ወይም orders: በርካታ፣ በኮማ የተለዩ

ምላሽ፣ አንድ ትዕዛዝ

{ "refill": "23501" }

ምላሽ፣ በርካታ

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
መለኪያመግለጫ
keyየእርስዎ API ቁልፍ
actionrefill_status
refillየሪፊል ID። ወይም refills: በርካታ፣ በኮማ የተለዩ

ምላሽ

{ "status": "Completed" }

ራውት በትዕዛዝ ምን ያደርጋል

  • እርምጃዎቹ የሚሞከሩት በእርስዎ ቅደም ተከተል ነው፣ ወይም ርካሹ የሚሠራ እርምጃ መጀመሪያ። የትኛው እንደሆነ በራውቱ ውስጥ ይመርጣሉ።
  • እርምጃ ይዘለላል — ፓነሉ መልስ ካልሰጠ፣ ቀሪ ሂሳቡ ወይም የዕለት ገደቡ ትዕዛዙን ካልሸፈነ፣ ብዛቱ ከሚቀበለው ውጭ ከሆነ፣ ዋጋው እርስዎ ካስቀመጡት ገደብ በላይ ከሆነ፣ ወይም በዋጋው ትዕዛዙ የራውቱን የራሱን የዕለት ገደብ የሚያልፍ ከሆነ። በራሱ ይመለሳል።
  • እርምጃ ከሥራ ይወጣል — አገልግሎቱ ከዋጋ ዝርዝሩ ሲወጣ፣ ወይም ፓነሉ በዚያው ID ሌላ ነገር መሸጥ ሲጀምር። ሌሎቹ እርምጃዎች መሥራታቸውን ይቀጥላሉ፣ እርስዎም ይነገርዎታል።
  • እምቢታ ትዕዛዙን ወደፊት ያንቀሳቅሳል። ፓነል መልስ ሰጥቶ እምቢ ሲል ምንም ገንዘብ አልተቀነሰም፤ ስለዚህ ቀጣዩ እርምጃ ይሞከራል።
  • ግልጽ መልስ ማጣት ያቆመዋል። የጊዜ ማብቂያ ወይም የተበላሸ መልስ ትዕዛዙ መኖሩን አይነግርም። ወደፊት መላክ ሁለት ጊዜ እንዲደርስና እንዲከፈል ሊያደርግ ይችላል፤ ስለዚህ ራውቱ ይቆማል፣ እርስዎም ያንን ትዕዛዝ በመለያዎ ውስጥ ይፈትሻሉ።
  • በአንድ ሊንክ አንድ እየሄደ ያለ ትዕዛዝ። ለአንድ ሊንክ የሚሆን ትዕዛዝ በራውት ላይ እየሄደ ሳለ ለዚያው ሊንክ ሁለተኛ ትዕዛዝ ውድቅ ይደረጋል፤ አቅራቢዎችም ራሳቸው እንዲሁ ያደርጋሉ።
  • ከማድረስ በፊት የሚደረግ ስረዛም ትዕዛዙን ወደፊት ሊያንቀሳቅስ ይችላል፣ ይህን ካበሩት። በከፊል የደረሰ ትዕዛዝ ያላደረሰው ወደፊት የሚሄደው እርስዎ ከጠየቁ ብቻ ነው።

ስህተቶች

ስህተትትርጉሙ
Invalid API keyቁልፉ የተሳሳተ፣ የተተካ ወይም የተሻረ ነው።
This key is limited to certain addresses…ጥያቄው በቁልፉ ዝርዝር ውስጥ ከሌለ አድራሻ መጥቷል።
Incorrect requestያልታወቀ action.
Incorrect service IDይህ 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 ጥሪ።
  • ቁልፉ የሚታየው አንድ ጊዜ ሲሆን የሚቀመጠው እንደ አሻራ ነው። እርስዎም ሆኑ እኛ እንደገና ልናነበው አንችልም። መተካቱ አሮጌውን ወዲያውኑ ያጠፋዋል።
  • የተፈቀዱ አድራሻዎች። የፓነልዎን ሰርቨር አድራሻ በመለያዎ ውስጥ ይዘርዝሩ፤ ቁልፉ ከሌላ ቦታ አይሠራም።
  • የራውት ID ሚስጥር አይደለም፤ ሚስጥር መሆንም አያስፈልገውም። የሚሠራው ራውቱ ባለቤት ከሆነው መለያ ቁልፍ ጋር ብቻ ነው።
  • ገደቦችዎ አሁንም ይሠራሉ። የእያንዳንዱ ፓነል የዕለት ገደብ፣ የራውቱ የራሱ የዕለት ገደብና ትልቁ ትዕዛዙ በAPI በኩል ለሚመጡ ትዕዛዞች በእጅ ለሚያስገቧቸው እንደሚሠሩት ልክ ይሠራሉ።
  • ገንዘብ በፍጹም በsmm.guide በኩል አያልፍም። እያንዳንዱ ትዕዛዝ የሚከፈለው ትዕዛዙን በሚቀበለው ፓነል ላይ ካለው ቀሪ ሂሳብዎ ነው። ተመላሽ ክፍያዎችና አለመግባባቶች በእርስዎና በዚያ ፓነል መካከል ይቆያሉ።

በምትኩ ካታሎጉን ማንበብ ይፈልጋሉ?

ፓነሎች፣ Trust Scores እና ቀጥታ ዋጋዎች የራሳቸው API እና ለረዳቶች የሚሆን MCP ሰርቨር አላቸው።