Home / Mga developer / Orders API
Orders API
Idagdag ang smm.guide sa iyong panel bilang provider. Bawat rutang binuo mo sa iyong account ay isang serbisyo na may sariling ID: nagpapadala ang iyong panel ng order sa ID na iyon, at ipinapasa ito ng ruta sa una sa iyong mga provider na makakatanggap nito.
Tatlong hakbang
Ito ang format na ginagamit na ng mga SMM panel sa pagitan nila, kaya walang kailangang i-program.
https://smm.guide/api/v2 at ang key. I-import ang mga serbisyo: darating ang iyong mga ruta kasama ang kanilang ID, presyo at limit.Format ng request
| HTTP method | POST |
| API URL | https://smm.guide/api/v2 |
| Body | application/x-www-form-urlencoded, o JSON na may Content-Type: application/json. A multipart/form-data na body ay binabasa rin, na siyang ipinapadala ng PHP kapag binigyan ng array ang cURL |
| Sagot | JSON, laging may HTTP 200, pati para sa body na hindi namin mabasa o request na masyadong malaki. Ang error ay {"error": "…"} |
| Pera | US dollar. Kada 1,000 ang mga presyo |
Listahan ng serbisyo
Ang iyong mga ruta na makakatanggap ng order ngayon. Hindi nakalista ang rutang naka-off, o ang rutang wala nang gumaganang hakbang.
| Parameter | Paglalarawan |
|---|---|
key | Ang iyong API key |
action | services |
Sagot
[
{
"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 ay ang pinakamahal sa mga hakbang ng ruta na maaaring tumanggap ng order, kasama ang mga nilaktawan sa ngayon (babalik bukas ang panel na down ngayon), kaya hindi kailanman lalampas ang halaga ng order sa presyong in-import ng iyong panel. min at max ay ang pinakamalawak na saklaw ng mga gumaganang hakbang kapag pinagsama; ang dami na kasya lang sa ilan sa mga ito ay mapupunta sa isa sa mga iyon. refill at cancel ay true kapag inaalok ito ng bawat ganoong hakbang.
Hindi isinasama sa listahang ito ang rutang naka-off, o walang hakbang na gagana, hanggang sa bumalik ito. Ang panel na awtomatikong nagsi-sync ng mga serbisyo nito ay mag-o-off sa serbisyong iyon sa panig nito sa parehong panahon, na siyang gusto mo: tatanggihan naman ang mga order nito.
Magdagdag ng order
| Parameter | Paglalarawan |
|---|---|
key | Ang iyong API key |
action | add |
service | Ang ID ng ruta, walong digit |
link | Link sa page, post o profile |
quantity | Kailangang dami |
Sagot
{
"order": 23501
}
Walang tumanggap nito
{
"error": "No step of this route accepted the order. …"
}Nananatiling pareho ang order number sa buong buhay ng order, alinmang provider man ang huling maghatid nito. Tumatanggap ang ruta ng link at dami; tinatanggihan ang drip-feed, comments at iba pang dagdag na field.
Status ng order
| Parameter | Paglalarawan |
|---|---|
key | Ang iyong API key |
action | status |
order | Order ID |
Sagot
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Paglalarawan |
|---|---|
key | Ang iyong API key |
action | status |
orders | Mga order ID na pinaghihiwalay ng kuwit, hanggang 100 |
Sagot
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Status | Kahulugan |
|---|---|
Pending | Tinanggap ng isang provider at hindi pa nagsisimula. Gayundin ang order na walang malinaw na sagot mula sa provider: humihinto doon ang ruta hanggang masuri mo ito sa iyong account. |
In progress, Processing | Inihahatid ito ng isang provider, o papunta na ang order sa susunod na hakbang. |
Completed | Naihatid nang buo. |
Partial | Bahagi lang ang naihatid; remains ay ang hindi naihatid. Binibilang nito ang naihatid ng bawat hakbang: kapag bahagi ang naihatid ng isang hakbang at nakansela ang natitira sa susunod, Partial ang order, hindi Canceled. Ang provider ang nagpapasya tungkol sa pagbabalik ng natitirang singil. |
Canceled | Walang naihatid, at walang ibang hakbang na tumanggap ng order. charge ay nagpapakita kung ano, kung mayroon man, ang nanatiling siningil. |
charge ay ang siningil ng mga provider para sa order na ito, sa dolyar ayon sa rate ng araw na inilagay ito. start_count ay galing sa provider na nagsimula nito.
Balanse
Walang hawak na pera mo ang smm.guide. Ang numero ay ang kabuuan ng iyong mga balanse sa mga panel sa likod ng iyong mga ruta, sa dolyar.
| Parameter | Paglalarawan |
|---|---|
key | Ang iyong API key |
action | balance |
Sagot
{
"balance": "126.1375",
"currency": "USD"
}Kanselahin
Ipinapasa sa provider na may hawak ng order ngayon, kung nag-aalok ng cancel ang serbisyo nito. Hindi kailanman ipinapasa sa susunod na hakbang ang order na kinansela mo.
| Parameter | Paglalarawan |
|---|---|
key | Ang iyong API key |
action | cancel |
orders | Mga order ID na pinaghihiwalay ng kuwit, hanggang 100 |
Sagot
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Refill
Ipinapasa sa provider na naghatid ng order. Dala ng refill ang sariling numero ng order.
| Parameter | Paglalarawan |
|---|---|
key | Ang iyong API key |
action | refill |
order | Order ID. O orders: ilan, pinaghihiwalay ng kuwit |
Sagot, isang order
{ "refill": "23501" }
Sagot, ilan
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Paglalarawan |
|---|---|
key | Ang iyong API key |
action | refill_status |
refill | Refill ID. O refills: ilan, pinaghihiwalay ng kuwit |
Sagot
{ "status": "Completed" }Ang ginagawa ng ruta sa isang order
- Sinusubukan ang mga hakbang ayon sa iyong pagkakasunod, o ang pinakamurang gumagana muna. Ikaw ang pipili kung alin sa ruta.
- Nilalaktawan ang hakbang kapag hindi sumasagot ang panel nito, hindi sapat ang balanse o arawang limit nito para sa order, nasa labas ng tinatanggap nito ang dami, mas mataas ang presyo nito kaysa sa limit na itinakda mo, o sa presyo nito ay lalampas ang order sa sariling arawang limit ng ruta. Kusa itong bumabalik.
- Inaalis ang hakbang kapag umalis ang serbisyo nito sa listahan ng presyo, o nagsimulang magbenta ang panel ng ibang bagay sa ilalim ng parehong ID. Patuloy na gumagana ang ibang hakbang, at sasabihan ka.
- Ipinapasa ng pagtanggi ang order. Kapag sumagot at tumanggi ang panel, walang siningil, kaya sinusubukan ang susunod na hakbang.
- Pinapahinto ito ng hindi malinaw na sagot. Hindi sinasabi ng timeout o sirang sagot kung umiiral ang order. Kung ipapasa ito, maaari itong maihatid at masingil nang dalawang beses, kaya humihinto ang ruta at susuriin mo ang order na iyon sa iyong account.
- Isang tumatakbong order kada link. Habang tumatakbo ang order para sa isang link sa isang ruta, tinatanggihan ang ikalawa para sa parehong link, gaya ng ginagawa mismo ng mga provider.
- Maaari ding maipasa ang cancel bago ang paghahatid, kung in-on mo iyon. Ang hindi naihatid ng bahagyang order ay ipinapasa lamang kung hiniling mo iyon.
Mga error
| Error | Ang ibig sabihin nito |
|---|---|
Invalid API key | Mali, napalitan o binawi ang key. |
This key is limited to certain addresses… | Galing ang request sa address na wala sa listahan ng key. |
Incorrect request | Hindi alam action. |
Incorrect service ID | Walang ruta mo na may ganitong ID. Pinapanatili ng rutang binura mo ang numero nito, at hindi ito kailanman ibinibigay sa iba. |
Incorrect order ID | Walang order mo na may ganitong numero. |
Link is required, Quantity is required | Ang isang field ng add ay nawawala o hindi numero. |
A route takes a link and a quantity only | May kasamang drip-feed, comments o ibang dagdag na field ang request. |
This route is switched off | I-on ito sa iyong account. |
This route already has an order for this link… | Hintaying matapos ang tumatakbo. |
No step of this route can take this order right now. … | Nilaktawan ang bawat hakbang bago may maipadala. Pinapangalanan ng teksto ang bawat panel at ang dahilan nito. |
No step of this route accepted the order. … | Tumanggi ang bawat hakbang na tinanong. Walang siningil. |
Too many requests… | Lampas sa limit sa ibaba. Maghintay ng isang minuto. |
Mga halimbawa
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]);
Ang add ay sinasagot sa loob ng 30 segundo, palagi. Maaaring magtanong ang ruta sa ilang provider nang sunod-sunod; makukuha ng bawat isa ang natitira sa oras na iyon, at hindi na tatanungin ang provider na hindi na mahihintay. Kung hindi pa sumasagot ang huling tinanong pagdating ng oras, makakatanggap ka ng order number na may status na Pending, at hihinto doon ang ruta hanggang malaman ang sagot. Sinasagot ang karamihan ng order sa loob ng isa o dalawang segundo.
Mga limit at seguridad
- 300 request kada minuto bawat key, 120 sa mga ito ay order. Hanggang 100 order ID sa isang
statusna tawag. - Isang beses lang ipinapakita ang key at iniingatan bilang fingerprint. Hindi na ito mababasa ulit mo man o namin. Kapag pinalitan ito, agad na mao-off ang luma.
- Mga pinapayagang address. Ilista ang address ng server ng iyong panel sa iyong account at hindi na gagana ang key mula saanman.
- Hindi sikreto ang route ID at hindi kailangang maging sikreto. Gumagana lang ito kasama ang key ng account na may-ari ng ruta.
- Umiiral pa rin ang iyong mga limit. Ang arawang limit ng bawat panel, ang sariling arawang limit ng ruta at ang pinakamalaking order nito ay naaangkop sa mga order na dumarating sa pamamagitan ng API gaya ng sa mga mano-mano mong inilalagay.
- Hindi kailanman dumadaan ang pera sa smm.guide. Binabayaran ang bawat order mula sa iyong balanse sa panel na tumatanggap nito. Nananatili sa pagitan mo at ng panel na iyon ang mga refund at dispute.
Katalogo ba ang babasahin mo?
May sariling API ang mga panel, Trust Score at live na presyo, at MCP server para sa mga assistant.