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": "…"}
ПариЩатски долари. Цените са за 1000

Списък с услуги

Вашите маршрути, които могат да приемат поръчка в момента. Маршрут, който е изключен или чиито стъпки са всички извън строя, не се показва.

ПараметърОписание
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 номера на поръчки в една status заявка.
  • Ключът се показва веднъж и се пази като отпечатък. Нито вие, нито ние можем да го прочетем отново. При замяна старият се изключва незабавно.
  • Разрешени адреси. Посочете адреса на сървъра на панела си в акаунта и ключът няма да работи от никъде другаде.
  • ID на маршрута не е тайна и не е нужно да бъде. Работи само заедно с ключа на акаунта, който притежава маршрута.
  • Лимитите ви остават в сила. Дневният лимит на всеки панел, собственият дневен лимит на маршрута и най-голямата му поръчка важат за поръчките, идващи през API, точно както за ръчно направените.
  • Парите никога не минават през smm.guide. Всяка поръчка се плаща от баланса ви в панела, който я поеме. Възстановяванията и споровете остават между вас и този панел.

Искате да четете каталога?

Панелите, Trust Score и актуалните цени имат собствен API, както и MCP сървър за асистенти.