Akèy / Devlopè / Orders API

Orders API

Ajoute smm.guide nan panèl ou kòm founisè. Chak wout ou kreye nan kont ou se yon sèvis ak pwòp ID li: panèl ou voye yon kòmand bay ID sa a, e wout la pase l bay premye founisè ou ki ka pran l.

Twa etap

Fòma a se sa panèl SMM yo deja itilize ant yo, kidonk pa gen anyen pou pwograme.

1Kreye yon woutKont, Orders desk, Wout. Chwazi sa li livre epi ajoute jiska senk sèvis kalite sa a nan panèl ou konekte yo.
2Kreye kle aOrders desk, Orders API. Kle a parèt yon sèl fwa. Ou ka limite l ak adrès sèvè panèl ou.
3Ajoute yon founisè nan panèl ouURL API https://smm.guide/api/v2 ak kle a. Enpòte sèvis yo: wout ou yo rive ak ID, pri ak limit yo.

Fòma demann

Metòd HTTPPOST
URL APIhttps://smm.guide/api/v2
Kòapplication/x-www-form-urlencoded, oswa JSON ak Content-Type: application/json. A multipart/form-data nou li kò sa a tou, se sa PHP voye lè yo bay cURL yon tablo
ReponsJSON, toujou ak HTTP 200, menm pou yon kò nou pa ka li oswa yon demann ki twò gwo. Yon erè se {"error": "…"}
LajanDola ameriken. Pri yo pou chak 1 000

Lis sèvis

Wout ou yo ki ka pran yon kòmand kounye a. Yon wout ki dezaktive, oswa ki gen tout etap li deyò, pa nan lis la.

ParamètDeskripsyon
keyKle API ou
actionservices

Repons

[
  {
    "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 se etap ki pi chè nan wout la ki ka pran yon kòmand, sa ki sote pou kounye a enkli (yon panèl ki an pann jodi a tounen demen), konsa yon kòmand pa janm koute plis pase pri panèl ou te enpòte a. min ak max se limit ki pi laj etap k ap mache yo aksepte ansanm; yon kantite ki anfòm sèlman pou kèk nan yo ale bay youn nan yo. refill ak cancel vo true lè tout etap sa yo ofri yo.

Yon wout ki dezaktive, oswa ki pa gen okenn etap ki ka mache, rete deyò lis sa a jiskaske li tounen. Yon panèl ki senkronize sèvis li otomatikman ap dezaktive sèvis sa a bò kote pa l pou menm tan an, e se sa ou vle: kòmand li yo t ap refize.

Ajoute kòmand

ParamètDeskripsyon
keyKle API ou
actionadd
serviceID wout la, uit chif
linkLyen paj, piblikasyon oswa pwofil la
quantityKantite ou bezwen

Repons

{
  "order": 23501
}

Okenn pa aksepte l

{
  "error": "No step of this route accepted the order. …"
}

Nimewo kòmand lan rete menm pandan tout vi kòmand lan, kèlkeswa founisè ki fini pa livre l. Yon wout pran yon lyen ak yon kantite; drip-feed, kòmantè ak lòt chan siplemantè yo refize.

Estati kòmand

ParamètDeskripsyon
keyKle API ou
actionstatus
orderID kòmand

Repons

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParamètDeskripsyon
keyKle API ou
actionstatus
ordersID kòmand separe ak vigil, jiska 100

Repons

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
EstatiSans
PendingYon founisè aksepte l e li poko kòmanse. Epi tou yon kòmand kote yon founisè pa t bay yon repons klè: wout la kanpe la jiskaske ou verifye l nan kont ou.
In progress, ProcessingYon founisè ap livre l, oswa kòmand lan sou wout pou pwochen etap la.
CompletedLivre nèt.
PartialYon pati livre; remains se sa ki pa t livre. Li konte sa chak etap livre: lè yon etap livre yon pati e rès la anile sou pwochen an, kòmand lan Pasyèl, pa Anile. Se founisè a ki deside si l ap remèt rès debi a.
CanceledAnyen pa t livre, e okenn lòt etap pa t pran kòmand lan. charge montre sa ki rete debite, si genyen.

charge se sa founisè yo debite pou kòmand sa a, an dola, ak to jou li te pase a. start_count soti nan founisè ki te kòmanse l la.

Balans

smm.guide pa kenbe okenn lajan pa w. Chif la se sòm balans ou sou panèl ki dèyè wout ou yo, an dola.

ParamètDeskripsyon
keyKle API ou
actionbalance

Repons

{
  "balance": "126.1375",
  "currency": "USD"
}

Anile

Pase bay founisè ki gen kòmand lan kounye a, si sèvis li ofri anilasyon. Yon kòmand ou anile pa janm voye bay pwochen etap la.

ParamètDeskripsyon
keyKle API ou
actioncancel
ordersID kòmand separe ak vigil, jiska 100

Repons

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

Refill

Pase bay founisè ki te livre kòmand lan. Refill la pote pwòp nimewo kòmand lan.

ParamètDeskripsyon
keyKle API ou
actionrefill
orderID kòmand. Oswa orders: plizyè, separe ak vigil

Repons, yon kòmand

{ "refill": "23501" }

Repons, plizyè

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParamètDeskripsyon
keyKle API ou
actionrefill_status
refillID refill. Oswa refills: plizyè, separe ak vigil

Repons

{ "status": "Completed" }

Sa yon wout fè ak yon kòmand

  • Etap yo eseye nan lòd ou, oswa sa ki pi bon mache k ap mache a an premye. Ou chwazi kilès nan wout la.
  • Nou sote yon etap lè panèl li pa reponn, balans li oswa limit chak jou li pa kouvri kòmand lan, kantite a deyò sa li pran, pri li pi wo pase limit ou fikse a, oswa ak pri li kòmand lan ta depase limit chak jou wout la. Li tounen pou kont li.
  • Yon etap soti lè sèvis li kite lis pri a, oswa panèl la kòmanse vann yon lòt bagay anba menm ID a. Lòt etap yo kontinye mache, e nou avèti w.
  • Yon refi fè kòmand lan avanse. Lè yon panèl reponn e li refize, pa gen anyen ki debite, kidonk nou eseye pwochen etap la.
  • Yon repons ki pa klè kanpe l. Yon tan depase oswa yon repons kase pa di si kòmand lan egziste. Si nou voye l bay yon lòt, li ka livre e debite de fwa, kidonk wout la kanpe e ou verifye kòmand sa a nan kont ou.
  • Yon sèl kòmand an kou pou chak lyen. Pandan yon kòmand pou yon lyen ap mache sou yon wout, nou refize yon dezyèm pou menm lyen an, menm jan founisè yo fè l.
  • Yon anilasyon anvan livrezon ka avanse tou, si ou te aktive sa. Sa yon kòmand pasyèl pa t livre avanse sèlman si ou te mande sa.

Erè

ErèSa li vle di
Invalid API keyKle a pa bon, li ranplase oswa li revoke.
This key is limited to certain addresses…Demann lan soti nan yon adrès ki pa nan lis kle a.
Incorrect requestEnkoni action.
Incorrect service IDOkenn nan wout ou yo pa gen ID sa a. Yon wout ou efase kenbe nimewo li, e nou pa janm bay yon lòt li.
Incorrect order IDOkenn nan kòmand ou yo pa gen nimewo sa a.
Link is required, Quantity is requiredYon chan nan add manke oswa se pa yon nimewo.
A route takes a link and a quantity onlyDemann lan te gen drip-feed, kòmantè oswa yon lòt chan siplemantè.
This route is switched offAktive l nan kont ou.
This route already has an order for this link…Tann jiskaske sa k ap mache a fini.
No step of this route can take this order right now. …Nou sote chak etap anvan nou voye anyen. Tèks la bay non chak panèl ak rezon li.
No step of this route accepted the order. …Chak etap nou mande refize. Nou pa debite anyen.
Too many requests…Ou depase limit ki anba a. Tann yon minit.

Egzanp

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]);

Yon add resevwa repons nan 30 segonn, toujou. Yon wout ka mande plizyè founisè youn apre lòt; chak resevwa sa ki rete nan tan sa a, e yon founisè nou pa t ka tann pa mande ditou. Si dènye founisè nou mande a poko reponn lè tan an fini, ou resevwa yon nimewo kòmand ak estati Pending, e wout la kanpe la jiskaske nou konnen repons lan. Pifò kòmand resevwa repons nan youn oswa de segonn.

Limit ak sekirite

  • 300 demann pa minit pou chak kle, ladan yo 120 kòmand. Jiska 100 ID kòmand nan yon sèl status apèl.
  • Kle a parèt yon sèl fwa e nou kenbe l kòm yon anprent. Ni ou ni nou pa ka li l ankò. Si ou ranplase l, ansyen an dezaktive touswit.
  • Adrès otorize. Mete adrès sèvè panèl ou nan kont ou epi kle a p ap mache okenn lòt kote.
  • Yon ID wout se pa yon sekrè, e li pa bezwen sekrè. Li mache sèlman ansanm ak kle kont ki posede wout la.
  • Limit ou yo toujou aplike. Limit chak jou chak panèl, limit chak jou wout la ak pi gwo kòmand li aplike pou kòmand ki rive atravè API a egzakteman menm jan ak sa ou pase alamen.
  • Lajan pa janm pase pa smm.guide. Chak kòmand peye ak balans ou sou panèl ki pran l la. Ranbousman ak diskisyon rete ant ou menm ak panèl sa a.

Ou pito li katalòg la?

Panèl, Trust Score ak pri an dirèk gen pwòp API pa yo, ak yon sèvè MCP pou asistan.