Почетна / За програмери / 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-сервер за асистенти.