Почетна / За програмере / 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 је оно што није испоручено. Рачуна се оно што је сваки корак испоручио: када је један корак испоручио део, а остатак је отказан на следећем, поруџбина је Делимична, а не Отказана. Провајдер одлучује о враћању остатка наплате. |
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 сервер за асистенте.