Kreu / Zhvilluesit / Orders API

Orders API

Shtojeni smm.guide në panelin tuaj si furnizues. Çdo rrugë që krijoni në llogarinë tuaj është një shërbim me ID-në e vet: paneli juaj i dërgon një porosi asaj ID-je dhe rruga ia kalon te i pari nga furnizuesit tuaj që mund ta marrë.

Tre hapa

Formati është ai që panelet SMM përdorin tashmë mes tyre, ndaj nuk ka asgjë për të programuar.

1Krijoni një rrugëLlogaria, Orders desk, Rrugët. Zgjidhni çfarë dorëzon dhe shtoni deri në pesë shërbime të atij lloji nga panelet që keni lidhur.
2Krijoni çelësinOrders desk, Orders API. Çelësi shfaqet një herë. Mund ta kufizoni në adresën e serverit të panelit tuaj.
3Shtoni një furnizues në panelin tuajURL-ja e API-së https://smm.guide/api/v2 dhe çelësin. Importoni shërbimet: rrugët tuaja vijnë me ID-të, çmimet dhe kufijtë e tyre.

Formati i kërkesës

Metoda HTTPPOST
URL-ja e API-sëhttps://smm.guide/api/v2
Trupiapplication/x-www-form-urlencoded, ose JSON me Content-Type: application/json. A multipart/form-data si trup lexohet gjithashtu, që është ajo që dërgon PHP kur cURL-it i jepet një array
PërgjigjjaJSON, gjithmonë me HTTP 200, edhe për një trup që nuk mund ta lexojmë ose një kërkesë shumë të madhe. Një gabim është {"error": "…"}
ParatëDollarë amerikanë. Çmimet janë për 1 000

Lista e shërbimeve

Rrugët tuaja që mund të marrin porosi tani. Një rrugë e çaktivizuar ose që i ka të gjithë hapat jashtë nuk listohet.

ParametriPërshkrimi
keyÇelësi juaj API
actionservices

Përgjigjja

[
  {
    "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 është më i shtrenjti nga hapat e rrugës që mund ta marrin porosinë, përfshirë ata të anashkaluar për momentin (një panel që sot nuk funksionon rikthehet nesër), ndaj një porosi nuk kushton kurrë më shumë se çmimi që importoi paneli juaj. min dhe max janë kufijtë më të gjerë që mbulojnë së bashku hapat funksionalë; një sasi që u përshtatet vetëm disa prej tyre shkon te njëri prej atyre. refill dhe cancel janë true kur çdo hap i tillë i ofron.

Një rrugë e çaktivizuar ose pa asnjë hap që mund të funksionojë mbetet jashtë kësaj liste derisa të rikthehet. Një panel që i sinkronizon shërbimet automatikisht do ta çaktivizojë atë shërbim nga ana e vet për të njëjtën kohë, dhe kjo është ajo që doni: porositë e tij do të refuzoheshin.

Shtoni porosi

ParametriPërshkrimi
keyÇelësi juaj API
actionadd
serviceID-ja e rrugës, tetë shifra
linkLidhja drejt faqes, postimit ose profilit
quantitySasia e nevojshme

Përgjigjja

{
  "order": 23501
}

Askush nuk e pranoi

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

Numri i porosisë mbetet i njëjtë gjatë gjithë jetës së porosisë, cilido furnizues ta dorëzojë në fund. Një rrugë merr një lidhje dhe një sasi; dërgimi gradual, komentet dhe fushat e tjera shtesë refuzohen.

Statusi i porosisë

ParametriPërshkrimi
keyÇelësi juaj API
actionstatus
orderID-ja e porosisë

Përgjigjja

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametriPërshkrimi
keyÇelësi juaj API
actionstatus
ordersID-të e porosive të ndara me presje, deri në 100

Përgjigjja

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusiKuptimi
PendingE pranuar nga një furnizues dhe ende e panisur. Gjithashtu një porosi për të cilën furnizuesi nuk dha përgjigje të qartë: rruga ndalet aty derisa ta keni kontrolluar në llogarinë tuaj.
In progress, ProcessingNjë furnizues po e dorëzon ose porosia është rrugës për te hapi tjetër.
CompletedDorëzuar plotësisht.
PartialDorëzuar pjesërisht; remains është ajo që nuk u dorëzua. Llogaritet ajo që dorëzoi çdo hap: kur një hap dorëzoi një pjesë dhe pjesa tjetër u anulua te hapi pasardhës, porosia është Partial, jo Canceled. Për kthimin e pjesës tjetër të tarifës vendos furnizuesi.
CanceledNuk u dorëzua asgjë dhe asnjë hap tjetër nuk e mori porosinë. charge tregon çfarë mbeti e tarifuar, nëse mbeti diçka.

charge është ajo që tarifuan furnizuesit për këtë porosi, në dollarë me kursin e ditës kur u bë. start_count vjen nga furnizuesi që e nisi.

Bilanci

smm.guide nuk mban asnjë para tuajën. Shifra është shuma e bilanceve tuaja në panelet pas rrugëve tuaja, në dollarë.

ParametriPërshkrimi
keyÇelësi juaj API
actionbalance

Përgjigjja

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

Anuloni

I kalohet furnizuesit që e mban porosinë tani, nëse shërbimi i tij ofron anulim. Një porosi që e anuloni nuk i dërgohet kurrë hapit tjetër.

ParametriPërshkrimi
keyÇelësi juaj API
actioncancel
ordersID-të e porosive të ndara me presje, deri në 100

Përgjigjja

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

Rimbushja

I kalohet furnizuesit që e dorëzoi porosinë. Rimbushja mban numrin e vetë porosisë.

ParametriPërshkrimi
keyÇelësi juaj API
actionrefill
orderID-ja e porosisë. Ose orders: disa, të ndara me presje

Përgjigjja, një porosi

{ "refill": "23501" }

Përgjigjja, disa

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametriPërshkrimi
keyÇelësi juaj API
actionrefill_status
refillID-ja e rimbushjes. Ose refills: disa, të ndara me presje

Përgjigjja

{ "status": "Completed" }

Çfarë bën një rrugë me një porosi

  • Hapat provohen sipas radhës suaj ose së pari ai funksional më i lirë. Ju zgjidhni cilën mënyrë në rrugë.
  • Një hap anashkalohet kur paneli i tij nuk përgjigjet, bilanci ose kufiri i tij ditor nuk e mbulon porosinë, sasia është jashtë asaj që pranon, çmimi i tij është mbi kufirin që keni vendosur, ose me çmimin e tij porosia do ta kalonte kufirin ditor të vetë rrugës. Rikthehet vetë.
  • Një hap del jashtë kur shërbimi i tij largohet nga lista e çmimeve ose paneli nis të shesë diçka tjetër me të njëjtën ID. Hapat e tjerë vazhdojnë të funksionojnë dhe ju njoftoheni.
  • Një refuzim e kalon porosinë më tej. Kur një panel përgjigjet dhe refuzon, nuk është tarifuar asgjë, ndaj provohet hapi tjetër.
  • Mungesa e përgjigjes së qartë e ndal. Një skadim kohe ose një përgjigje e prishur nuk tregon nëse porosia ekziston. Kalimi i saj më tej mund ta dorëzonte dhe ta tarifonte dy herë, ndaj rruga ndalet dhe ju e kontrolloni atë porosi në llogarinë tuaj.
  • Një porosi aktive për lidhje. Ndërsa një porosi për një lidhje është në ekzekutim në një rrugë, një e dytë për të njëjtën lidhje refuzohet, ashtu siç bëjnë vetë furnizuesit.
  • Edhe një anulim para dorëzimit mund të kalojë më tej, nëse e keni aktivizuar këtë. Ajo që një porosi e pjesshme la pa dorëzuar kalon më tej vetëm nëse e keni kërkuar.

Gabimet

GabimiÇfarë do të thotë
Invalid API keyÇelësi është i gabuar, i zëvendësuar ose i shfuqizuar.
This key is limited to certain addresses…Kërkesa erdhi nga një adresë që nuk është në listën e çelësit.
Incorrect requestE panjohur action.
Incorrect service IDAsnjë rrugë e juaja nuk e ka këtë ID. Një rrugë e fshirë e ruan numrin e saj dhe ai nuk i jepet kurrë një tjetre.
Incorrect order IDAsnjë porosi e juaja nuk e ka këtë numër.
Link is required, Quantity is requiredNjë fushë e add mungon ose nuk është numër.
A route takes a link and a quantity onlyKërkesa përmbante dërgim gradual, komente ose një fushë tjetër shtesë.
This route is switched offAktivizojeni në llogarinë tuaj.
This route already has an order for this link…Prisni derisa të përfundojë ajo që është në ekzekutim.
No step of this route can take this order right now. …Çdo hap u anashkalua para se të dërgohej diçka. Teksti emërton çdo panel dhe arsyen e tij.
No step of this route accepted the order. …Çdo hap që u pyet refuzoi. Nuk u tarifua asgjë.
Too many requests…Mbi kufirin më poshtë. Prisni një minutë.

Shembuj

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

Thirrja add merr gjithmonë përgjigje brenda 30 sekondave. Një rrugë mund të pyesë disa furnizues njëri pas tjetrit; secili merr atë që ka mbetur nga kjo kohë dhe një furnizues që nuk mund të pritej nuk pyetet fare. Nëse i fundit i pyetur nuk është përgjigjur kur mbaron koha, merrni një numër porosie me statusin Pending dhe rruga ndalet aty derisa të dihet përgjigjja. Shumica e porosive marrin përgjigje brenda një ose dy sekondave.

Kufijtë dhe siguria

  • 300 kërkesa në minutë për çelës, nga të cilat 120 porosi. Deri në 100 ID porosish në një status thirrje.
  • Çelësi shfaqet një herë dhe ruhet si gjurmë. As ju, as ne nuk mund ta lexojmë përsëri. Zëvendësimi e çaktivizon menjëherë të vjetrin.
  • Adresat e lejuara. Shënoni adresën e serverit të panelit tuaj në llogarinë tuaj dhe çelësi nuk funksionon nga askund tjetër.
  • ID-ja e rrugës nuk është sekret dhe nuk ka nevojë të jetë. Funksionon vetëm bashkë me çelësin e llogarisë që zotëron rrugën.
  • Kufijtë tuaj vazhdojnë të vlejnë. Kufiri ditor i çdo paneli, kufiri ditor i vetë rrugës dhe porosia e saj më e madhe zbatohen për porositë që vijnë përmes API-së njësoj si për ato që bëni me dorë.
  • Paratë nuk kalojnë kurrë përmes smm.guide. Çdo porosi paguhet nga bilanci juaj në panelin që e merr. Rimbursimet dhe mosmarrëveshjet mbeten mes jush dhe atij paneli.

Doni të lexoni katalogun?

Panelet, Trust Score dhe çmimet e drejtpërdrejta kanë API-në e tyre dhe një server MCP për asistentët.