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