Baş sahypa / Işläp düzüjiler üçin / Orders API
Orders API
smm.guide-y paneliňize üpjün ediji hökmünde goşuň. Hasabyňyzda gurýan her marşrutyňyz öz ID-si bolan hyzmatdyr: paneliňiz sargydy şol ID-ä iberýär, marşrut bolsa ony üpjün edijileriňiziň ony alyp biljek birinjisine geçirýär.
Üç ädim
Format SMM panelleriniň öz aralarynda eýýäm ulanýan formatydyr, şonuň üçin hiç zat programmirlemeli däl.
https://smm.guide/api/v2 we açary goýuň. Hyzmatlary import ediň: marşrutlaryňyz ID-leri, bahalary we çäkleri bilen gelýär.Soragyň formaty
| HTTP usuly | POST |
| API URL | https://smm.guide/api/v2 |
| Body | application/x-www-form-urlencoded, ýa-da JSON, şu bilen: Content-Type: application/json. A multipart/form-data body hem okalýar: PHP-de cURL-a massiw berlende şeýle iberilýär |
| Jogap | JSON, elmydama HTTP 200 bilen, okap bilmeýän body-myz ýa-da gaty uly sorag üçin hem. Ýalňyşlyk şeýle görnüşde: {"error": "…"} |
| Pul | ABŞ dollary. Bahalar 1 000 üçin |
Hyzmatlaryň sanawy
Häzir sargyt alyp bilýän marşrutlaryňyz. Öçürilen ýa-da ähli ädimleri çykan marşrut sanawda görkezilmeýär.
| Parametr | Düşündiriş |
|---|---|
key | API açaryňyz |
action | services |
Jogap
[
{
"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 marşrutyň sargyt alyp biljek ädimleriniň iň gymmadydyr, häzirlikçe geçilýänler hem goşmak bilen (şu gün işlemeýän panel ertir dolanyp gelýär), şeýlelikde sargyt hiç haçan paneliňiziň import eden bahasyndan gymmat düşmeýär. min we max işleýän ädimleriň bilelikde kabul edýän iň giň çäkleridir; diňe käbirine laýyk gelýän mukdar şolaryň birine gidýär. refill we cancel şeýle ädimleriň hemmesi olary teklip edende true bolýar.
Öçürilen ýa-da işläp biljek hiç bir ädimi bolmadyk marşrut yzyna dolanýança bu sanawdan çykarylýar. Hyzmatlaryny awtomatik sinhronlaşdyrýan panel şol hyzmaty şol wagt üçin öz tarapynda öçürer, bu-da siziň isleýän zadyňyz: onuň sargytlary ret ediler.
Sargyt goşuň
| Parametr | Düşündiriş |
|---|---|
key | API açaryňyz |
action | add |
service | Marşrutyň ID-si, sekiz san |
link | Sahypa, ýazga ýa-da profile salgylanma |
quantity | Gerekli mukdar |
Jogap
{
"order": 23501
}
Hiç kim kabul etmedi
{
"error": "No step of this route accepted the order. …"
}Sargydyň belgisi, ony haýsy üpjün ediji ýerine ýetirse-de, sargydyň bütin ömründe üýtgemeýär. Marşrut salgylanma we mukdar kabul edýär; tapgyrlaýyn ýerine ýetiriş, teswirler we beýleki goşmaça meýdançalar ret edilýär.
Sargydyň ýagdaýy
| Parametr | Düşündiriş |
|---|---|
key | API açaryňyz |
action | status |
order | Sargyt ID |
Jogap
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametr | Düşündiriş |
|---|---|
key | API açaryňyz |
action | status |
orders | Sargyt ID-leri, otur bilen bölünen, 100 çenli |
Jogap
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Ýagdaý | Manysy |
|---|---|
Pending | Üpjün ediji tarapyndan kabul edildi we entek başlanmady. Şeýle hem üpjün edijiniň anyk jogap bermedik sargydy: siz ony hasabyňyzda barlaýançaňyz marşrut şol ýerde togtaýar. |
In progress, Processing | Üpjün ediji ony ýerine ýetirýär ýa-da sargyt indiki ädime barýar. |
Completed | Doly ýerine ýetirildi. |
Partial | Bölekleýin ýerine ýetirildi; remains ýerine ýetirilmedik bölegi görkezýär. Ol her ädimiň ýerine ýetiren zadyny hasaplaýar: bir ädim bölegini ýerine ýetirip, galany indikisinde ýatyrylanda sargyt «Ýatyryldy» däl-de, «Bölekleýin» bolýar. Tutumyň galanyny gaýtarmak barada üpjün ediji karar berýär. |
Canceled | Hiç zat ýerine ýetirilmedi we başga hiç bir ädim sargydy almady. charge tutulyp galan zat bar bolsa, şony görkezýär. |
charge üpjün edijileriň bu sargyt üçin tutan mukdarydyr, sargyt berlen günüň hümmeti boýunça dollarda. start_count ony başlan üpjün edijiden gelýär.
Balans
smm.guide siziň pulyňyzy saklamaýar. Bu san marşrutlaryňyzyň aňyrsyndaky panellerdäki balanslaryňyzyň dollardaky jemidir.
| Parametr | Düşündiriş |
|---|---|
key | API açaryňyz |
action | balance |
Jogap
{
"balance": "126.1375",
"currency": "USD"
}Ýatyryň
Sargydy häzir saklaýan üpjün edijä, onuň hyzmaty ýatyrmagy teklip edýän bolsa, geçirilýär. Siziň ýatyran sargydyňyz hiç haçan indiki ädime iberilmeýär.
| Parametr | Düşündiriş |
|---|---|
key | API açaryňyz |
action | cancel |
orders | Sargyt ID-leri, otur bilen bölünen, 100 çenli |
Jogap
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Gaýtadan doldurma
Sargydy ýerine ýetiren üpjün edijä geçirilýär. Gaýtadan doldurma sargydyň öz belgisini göterýär.
| Parametr | Düşündiriş |
|---|---|
key | API açaryňyz |
action | refill |
order | Sargyt ID. Ýa-da orders: birnäçesi, otur bilen bölünen |
Jogap, bir sargyt
{ "refill": "23501" }
Jogap, birnäçesi
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parametr | Düşündiriş |
|---|---|
key | API açaryňyz |
action | refill_status |
refill | Gaýtadan doldurma ID. Ýa-da refills: birnäçesi, otur bilen bölünen |
Jogap
{ "status": "Completed" }Marşrut sargyt bilen näme edýär
- Ädimler siziň tertibiňizde ýa-da ilki iň arzan işleýäni synanyşylýar. Haýsysydygyny marşrutda saýlaýarsyňyz.
- Ädim geçilýär, haçan-da onuň paneli jogap bermese, balansy ýa-da gündelik çägi sargydy ýapmasa, mukdar onuň kabul edýän çäginden daşarda bolsa, bahasy siziň bellän çägiňizden ýokary bolsa ýa-da onuň bahasynda sargyt marşrutyň öz gündelik çäginden geçse. Ol özi yzyna gaýdyp gelýär.
- Ädim çykýar, haçan-da onuň hyzmaty baha sanawyndan aýrylsa ýa-da panel şol bir ID bilen başga bir zat satyp başlasa. Beýleki ädimler işlemegini dowam edýär we size habar berilýär.
- Ret etmek sargydy öňe geçirýär. Panel jogap berip ret edende hiç zat tutulmadyk bolýar, şonuň üçin indiki ädim synanyşylýar.
- Anyk jogabyň ýoklugy ony togtadýar. Wagtyň gutarmagy ýa-da bozuk jogap sargydyň bardygyny ýa-da ýokdugyny aýtmaýar. Ony indikä ibermek iki gezek ýerine ýetirip, iki gezek tutup biler, şonuň üçin marşrut togtaýar we siz şol sargydy hasabyňyzda barlaýarsyňyz.
- Bir salgylanma üçin bir işleýän sargyt. Marşrutda bir salgylanma üçin sargyt işläp durka, şol salgylanma üçin ikinji sargyt ret edilýär, üpjün edijileriň özleri hem şeýle edýär.
- Ýerine ýetirilmezden öňki ýatyrma hem öňe geçip biler, eger siz muny açan bolsaňyz. Bölekleýin sargydyň ýerine ýetirmän galdyran bölegi diňe siz muny soran bolsaňyz öňe geçýär.
Ýalňyşlyklar
| Ýalňyşlyk | Manysy |
|---|---|
Invalid API key | Açar nädogry, çalşyryldy ýa-da ýatyryldy. |
This key is limited to certain addresses… | Sorag açaryň sanawynda ýok salgydan geldi. |
Incorrect request | Näbelli action. |
Incorrect service ID | Bu ID bilen marşrutyňyz ýok. Pozan marşrutyňyz belgisini saklaýar we ol hiç haçan başga birine berilmeýär. |
Incorrect order ID | Bu belgi bilen sargydyňyz ýok. |
Link is required, Quantity is required | Şu meýdançalaryň biri add ýok ýa-da san däl. |
A route takes a link and a quantity only | Soragda tapgyrlaýyn ýerine ýetiriş, teswirler ýa-da başga goşmaça meýdança bardy. |
This route is switched off | Ony hasabyňyzda açyň. |
This route already has an order for this link… | Işleýän sargyt gutarýança garaşyň. |
No step of this route can take this order right now. … | Hiç zat iberilmezden öň ähli ädimler geçildi. Tekstde her panel we onuň sebäbi görkezilýär. |
No step of this route accepted the order. … | Soralan ähli ädimler ret etdi. Hiç zat tutulmady. |
Too many requests… | Aşakdaky çäkden geçildi. Bir minut garaşyň. |
Mysallar
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]);
Her add soragyna elmydama 30 sekundyň içinde jogap berilýär. Marşrut birnäçe üpjün edijä yzly-yzyna ýüz tutup biler; her biri şol wagtyň galan bölegini alýar, garaşyp bolmajak üpjün edijä asla ýüz tutulmaýar. Wagt gutaranda soňky soralan üpjün ediji jogap bermedik bolsa, Pending ýagdaýly sargyt belgisini alýarsyňyz we jogap belli bolýança marşrut şol ýerde togtaýar. Sargytlaryň köpüsine bir-iki sekundda jogap berilýär.
Çäkler we howpsuzlyk
- Bir açar üçin minutda 300 sorag, olaryň 120 sanysy sargyt. Bir gezekde 100 sargyt ID-sine çenli
statussorag. - Açar bir gezek görkezilýär we barmak yzy hökmünde saklanýar. Ony ne siz, ne-de biz gaýtadan okap bilmeýäris. Ony çalşanyňyzda köne açar derrew öçýär.
- Rugsat berlen salgylar. Hasabyňyzda paneliňiziň serweriniň salgysyny görkeziň, şonda açar başga hiç ýerden işlemeýär.
- Marşrut ID-si gizlin däl we gizlin bolmagy hem gerek däl. Ol diňe marşrutyň eýesi bolan hasabyň açary bilen bilelikde işleýär.
- Çäkleriňiz güýjünde galýar. Her paneliň gündelik çägi, marşrutyň öz gündelik çägi we onuň iň uly sargydy API arkaly gelýän sargytlara hem el bilen berýän sargytlaryňyz ýaly ulanylýar.
- Pul hiç haçan smm.guide arkaly geçmeýär. Her sargyt ony kabul eden paneldäki balansyňyzdan tölenýär. Gaýtarmalar we jedeller siz bilen şol paneliň arasynda galýar.
Munuň ýerine katalogy okamakçymy?
Panelleriň, Trust Score-laryň we janly bahalaryň öz API-si we kömekçiler üçin MCP serweri bar.