Orders API
smm.guideን በፓነልዎ ውስጥ እንደ አቅራቢ ያክሉ። በመለያዎ ውስጥ የሚገነቡት እያንዳንዱ ራውት የራሱ ID ያለው አገልግሎት ነው: ፓነልዎ ትዕዛዝን ወደዚያ ID ይልካል፣ ራውቱም ትዕዛዙን ሊቀበሉት ከሚችሉ አቅራቢዎችዎ ወደ መጀመሪያው ያስተላልፋል።
ሦስት እርምጃዎች
ቅርጸቱ SMM ፓነሎች አስቀድመው እርስ በርሳቸው የሚጠቀሙበት ነው፤ ስለዚህ ፕሮግራም የሚደረግ ምንም ነገር የለም።
https://smm.guide/api/v2 እና ቁልፉ። አገልግሎቶቹን ያስመጡ: ራውቶችዎ ከIDዎቻቸው፣ ከዋጋዎቻቸውና ከገደቦቻቸው ጋር ይመጣሉ።የጥያቄ ቅርጸት
| HTTP ዘዴ | POST |
| API URL | https://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 ቁልፍ |
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 | የራውቱ ID፣ ስምንት አኃዞች |
link | ወደ ገጹ፣ ልጥፉ ወይም መገለጫው የሚወስድ ሊንክ |
quantity | የሚያስፈልገው ብዛት |
ምላሽ
{
"order": 23501
}
ማንም አልተቀበለውም
{
"error": "No step of this route accepted the order. …"
}በመጨረሻ የትኛውም አቅራቢ ቢያደርሰው የትዕዛዙ ቁጥር በትዕዛዙ የሕይወት ዘመን ሁሉ ያው ይቆያል። ራውት ሊንክና ብዛት ይቀበላል፤ ድሪፕ-ፊድ፣ አስተያየቶችና ሌሎች ተጨማሪ መስኮች ውድቅ ይደረጋሉ።
የትዕዛዝ ሁኔታ
| መለኪያ | መግለጫ |
|---|---|
key | የእርስዎ API ቁልፍ |
action | status |
order | የትዕዛዝ ID |
ምላሽ
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| መለኪያ | መግለጫ |
|---|---|
key | የእርስዎ API ቁልፍ |
action | status |
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 ቁልፍ |
action | balance |
ምላሽ
{
"balance": "126.1375",
"currency": "USD"
}ይሰርዙ
አገልግሎቱ ስረዛን የሚፈቅድ ከሆነ ትዕዛዙን አሁን ወደያዘው አቅራቢ ይተላለፋል። እርስዎ የሰረዙት ትዕዛዝ ወደ ቀጣዩ እርምጃ በፍጹም አይላክም።
| መለኪያ | መግለጫ |
|---|---|
key | የእርስዎ API ቁልፍ |
action | cancel |
orders | በኮማ የተለዩ የትዕዛዝ IDዎች፣ እስከ 100 |
ምላሽ
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]ሪፊል
ትዕዛዙን ወዳደረሰው አቅራቢ ይተላለፋል። ሪፊሉ የትዕዛዙን የራሱን ቁጥር ይይዛል።
| መለኪያ | መግለጫ |
|---|---|
key | የእርስዎ API ቁልፍ |
action | refill |
order | የትዕዛዝ ID። ወይም orders: በርካታ፣ በኮማ የተለዩ |
ምላሽ፣ አንድ ትዕዛዝ
{ "refill": "23501" }
ምላሽ፣ በርካታ
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| መለኪያ | መግለጫ |
|---|---|
key | የእርስዎ API ቁልፍ |
action | refill_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 ሰርቨር አላቸው።