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