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 մարմինը նույնպես կարդացվում է. դա այն է, ինչ 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Երթուղու 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 պատվերի ID մեկ status կանչ։
  • Բանալին ցուցադրվում է մեկ անգամ և պահվում է որպես դրոշմ։ Ո՛չ դուք, ո՛չ մենք այն կրկին կարդալ չենք կարող։ Փոխարինելիս հինն անմիջապես անջատվում է։
  • Թույլատրված հասցեներ։ Նշեք ձեր պանելի սերվերի հասցեն ձեր հաշվում, և բանալին ուրիշ ոչ մի տեղից չի աշխատի։
  • Երթուղու ID-ն գաղտնիք չէ և պետք չէ, որ լինի։ Այն աշխատում է միայն երթուղու տեր հաշվի բանալու հետ միասին։
  • Ձեր սահմանաչափերը գործում են։ Յուրաքանչյուր պանելի օրական սահմանաչափը, երթուղու սեփական օրական սահմանաչափը և առավելագույն պատվերը կիրառվում են API-ով եկող պատվերների նկատմամբ ճիշտ այնպես, ինչպես ձեռքով կատարվողների։
  • Գումարը երբեք չի անցնում smm.guide-ի միջով։ Յուրաքանչյուր պատվեր վճարվում է ձեր հաշվեկշռից այն պանելում, որն ընդունում է այն։ Վերադարձներն ու վեճերը մնում են ձեր և այդ պանելի միջև։

Ցանկանո՞ւմ եք կարդալ կատալոգը

Պանելները, Trust Score-երը և արդիական գներն ունեն իրենց սեփական API-ն և MCP սերվեր օգնականների համար։