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
serviceID на рутата, осум цифри
linkЛинк до страницата, објавата или профилот
quantityПотребна количина

Одговор

{
  "order": 23501
}

Никој не ја прифати

{
  "error": "No step of this route accepted the order. …"
}

Бројот на нарачката останува ист за цело времетраење на нарачката, без разлика кој добавувач на крајот ја испорачува. Рутата прима линк и количина; постепена испорака, коментари и други дополнителни полиња се одбиваат.

Статус на нарачката

ПараметарОпис
keyВашиот клуч за API
actionstatus
orderID на нарачката

Одговор

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ПараметарОпис
keyВашиот клуч за API
actionstatus
ordersID на нарачки одделени со запирка, до 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
ordersID на нарачки одделени со запирка, до 100

Одговор

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

Дополнување

Се проследува до добавувачот што ја испорачал нарачката. Дополнувањето го носи бројот на самата нарачка.

ПараметарОпис
keyВашиот клуч за API
actionrefill
orderID на нарачката. Или orders: неколку, одделени со запирка

Одговор, една нарачка

{ "refill": "23501" }

Одговор, неколку

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ПараметарОпис
keyВашиот клуч за API
actionrefill_status
refillID на дополнувањето. Или 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-сервер за асистенти.