Начало / За разработчици / 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": "…"} |
| Пари | Щатски долари. Цените са за 1000 |
Списък с услуги
Вашите маршрути, които могат да приемат поръчка в момента. Маршрут, който е изключен или чиито стъпки са всички извън строя, не се показва.
| Параметър | Описание |
|---|---|
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 номера на поръчки в една
statusзаявка. - Ключът се показва веднъж и се пази като отпечатък. Нито вие, нито ние можем да го прочетем отново. При замяна старият се изключва незабавно.
- Разрешени адреси. Посочете адреса на сървъра на панела си в акаунта и ключът няма да работи от никъде другаде.
- ID на маршрута не е тайна и не е нужно да бъде. Работи само заедно с ключа на акаунта, който притежава маршрута.
- Лимитите ви остават в сила. Дневният лимит на всеки панел, собственият дневен лимит на маршрута и най-голямата му поръчка важат за поръчките, идващи през API, точно както за ръчно направените.
- Парите никога не минават през smm.guide. Всяка поръчка се плаща от баланса ви в панела, който я поеме. Възстановяванията и споровете остават между вас и този панел.
Искате да четете каталога?
Панелите, Trust Score и актуалните цени имат собствен API, както и MCP сървър за асистенти.