Нүүр / Хөгжүүлэгчдэд / 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 биеийг ч уншина; cURL-д массив өгөхөд PHP яг үүнийг илгээдэг |
| Хариу | 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 нь биелээгүй хэсэг. Энэ нь бүх алхмын биелүүлснийг тооцдог: нэг алхам хэсгийг нь биелүүлж, үлдсэнийг дараагийн алхамд цуцалсан бол захиалга Canceled биш, Partial болно. Төлбөрийн үлдсэн хэсгийг буцаах эсэхийг нийлүүлэгч шийднэ. |
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 сервертэй.