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.

1Bumuo ng rutaAccount, Orders desk, Mga ruta. Piliin kung ano ang ihahatid nito at magdagdag ng hanggang limang serbisyo ng ganoong uri mula sa mga panel na naikonekta mo.
2Gawin ang keyOrders desk, Orders API. Isang beses lang ipinapakita ang key. Puwede mo itong limitahan sa address ng server ng iyong panel.
3Magdagdag ng provider sa iyong panelAPI URL 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 methodPOST
API URLhttps://smm.guide/api/v2
Bodyapplication/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
SagotJSON, laging may HTTP 200, pati para sa body na hindi namin mabasa o request na masyadong malaki. Ang error ay {"error": "…"}
PeraUS 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.

ParameterPaglalarawan
keyAng iyong API key
actionservices

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

ParameterPaglalarawan
keyAng iyong API key
actionadd
serviceAng ID ng ruta, walong digit
linkLink sa page, post o profile
quantityKailangang 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

ParameterPaglalarawan
keyAng iyong API key
actionstatus
orderOrder ID

Sagot

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterPaglalarawan
keyAng iyong API key
actionstatus
ordersMga 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" }
}
StatusKahulugan
PendingTinanggap 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, ProcessingInihahatid ito ng isang provider, o papunta na ang order sa susunod na hakbang.
CompletedNaihatid nang buo.
PartialBahagi 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.
CanceledWalang 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.

ParameterPaglalarawan
keyAng iyong API key
actionbalance

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.

ParameterPaglalarawan
keyAng iyong API key
actioncancel
ordersMga 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.

ParameterPaglalarawan
keyAng iyong API key
actionrefill
orderOrder ID. O orders: ilan, pinaghihiwalay ng kuwit

Sagot, isang order

{ "refill": "23501" }

Sagot, ilan

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterPaglalarawan
keyAng iyong API key
actionrefill_status
refillRefill 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

ErrorAng ibig sabihin nito
Invalid API keyMali, napalitan o binawi ang key.
This key is limited to certain addresses…Galing ang request sa address na wala sa listahan ng key.
Incorrect requestHindi alam action.
Incorrect service IDWalang ruta mo na may ganitong ID. Pinapanatili ng rutang binura mo ang numero nito, at hindi ito kailanman ibinibigay sa iba.
Incorrect order IDWalang order mo na may ganitong numero.
Link is required, Quantity is requiredAng isang field ng add ay nawawala o hindi numero.
A route takes a link and a quantity onlyMay kasamang drip-feed, comments o ibang dagdag na field ang request.
This route is switched offI-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 status na 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.