Etusivu / Kehittäjille / Orders API

Orders API

Lisää smm.guide paneeliisi toimittajaksi. Jokainen tililläsi luomasi reitti on palvelu, jolla on oma ID: paneelisi lähettää tilauksen tähän ID:hen, ja reitti välittää sen ensimmäiselle toimittajallesi, joka voi ottaa sen.

Kolme vaihetta

Muoto on sama, jota SMM-paneelit jo käyttävät keskenään, joten mitään ei tarvitse ohjelmoida.

1Luo reittiTili, Orders desk, Reitit. Valitse, mitä reitti toimittaa, ja lisää enintään viisi samantyyppistä palvelua yhdistämistäsi paneeleista.
2Luo avainOrders desk, Orders API. Avain näytetään vain kerran. Voit rajoittaa sen paneelisi palvelimen osoitteeseen.
3Lisää toimittaja paneeliisiAPI-URL https://smm.guide/api/v2 ja avain. Tuo palvelut: reittisi tulevat ID:ineen, hintoineen ja rajoineen.

Pyynnön muoto

HTTP-metodiPOST
API-URLhttps://smm.guide/api/v2
Runkoapplication/x-www-form-urlencoded, tai JSON otsakkeella Content-Type: application/json. A multipart/form-data -muotoinen runko luetaan myös; sellaisen PHP lähettää, kun cURLille annetaan taulukko
VastausJSON, aina HTTP 200 -tilakoodilla, myös rungolle, jota emme voi lukea, tai liian suurelle pyynnölle. Virhe on {"error": "…"}
RahaYhdysvaltain dollarit. Hinnat ovat per 1 000

Palveluluettelo

Reittisi, jotka voivat ottaa tilauksen juuri nyt. Reittiä, joka on kytketty pois tai jonka kaikki vaiheet ovat poissa käytöstä, ei listata.

ParametriKuvaus
keyAPI-avaimesi
actionservices

Vastaus

[
  {
    "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 on reitin vaiheista kallein, joka voi ottaa tilauksen, mukaan lukien hetkellisesti ohitetut (tänään alhaalla oleva paneeli on huomenna taas toiminnassa), joten tilaus ei koskaan maksa enempää kuin paneelisi tuoma hinta. min ja max ovat laajimmat rajat, jotka toimivat vaiheet yhdessä kattavat; määrä, joka sopii vain osaan niistä, ohjataan jollekin niistä. refill ja cancel ovat true, kun jokainen tällainen vaihe tarjoaa ne.

Reitti, joka on kytketty pois tai jolla ei ole toimivaa vaihetta, jätetään tämän luettelon ulkopuolelle, kunnes se palaa. Paneeli, joka synkronoi palvelunsa automaattisesti, kytkee kyseisen palvelun omalta puoleltaan pois samaksi ajaksi, ja juuri niin pitääkin: sen tilaukset hylättäisiin.

Lisää tilaus

ParametriKuvaus
keyAPI-avaimesi
actionadd
serviceReitin ID, kahdeksan numeroa
linkLinkki sivuun, julkaisuun tai profiiliin
quantityTarvittava määrä

Vastaus

{
  "order": 23501
}

Kukaan ei hyväksynyt sitä

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

Tilausnumero pysyy samana tilauksen koko elinkaaren ajan riippumatta siitä, mikä toimittaja sen lopulta toimittaa. Reitti ottaa vastaan linkin ja määrän; vaiheittainen toimitus, kommentit ja muut lisäkentät hylätään.

Tilauksen tila

ParametriKuvaus
keyAPI-avaimesi
actionstatus
orderTilauksen ID

Vastaus

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametriKuvaus
keyAPI-avaimesi
actionstatus
ordersTilausten ID:t pilkulla erotettuina, enintään 100

Vastaus

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
TilaMerkitys
PendingToimittaja on hyväksynyt tilauksen, mutta sitä ei ole vielä aloitettu. Myös tilaus, josta toimittaja ei antanut selvää vastausta: reitti pysähtyy siihen, kunnes olet tarkistanut sen tililläsi.
In progress, ProcessingToimittaja toimittaa sitä, tai tilaus on siirtymässä seuraavaan vaiheeseen.
CompletedToimitettu kokonaan.
PartialOsa toimitettu; remains kertoo, mitä ei toimitettu. Siinä lasketaan kaikkien vaiheiden toimitukset: kun yksi vaihe toimitti osan ja loput peruttiin seuraavassa, tilaus on Osittainen, ei Peruttu. Toimittaja päättää veloituksen loppuosan palauttamisesta.
CanceledMitään ei toimitettu, eikä mikään muu vaihe ottanut tilausta. charge näyttää, mitä veloitukseksi mahdollisesti jäi.

charge on se, mitä toimittajat veloittivat tästä tilauksesta, dollareina tilauksen tekopäivän kurssilla. start_count tulee toimittajalta, joka aloitti tilauksen.

Saldo

smm.guide ei säilytä rahojasi. Luku on saldojesi summa dollareina niissä paneeleissa, joita reittisi käyttävät.

ParametriKuvaus
keyAPI-avaimesi
actionbalance

Vastaus

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

Peruuta

Välitetään toimittajalle, jolla tilaus nyt on, jos sen palvelu tarjoaa peruutuksen. Perumaasi tilausta ei koskaan lähetetä seuraavaan vaiheeseen.

ParametriKuvaus
keyAPI-avaimesi
actioncancel
ordersTilausten ID:t pilkulla erotettuina, enintään 100

Vastaus

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

Täydennys

Välitetään toimittajalle, joka toimitti tilauksen. Täydennyksellä on tilauksen oma numero.

ParametriKuvaus
keyAPI-avaimesi
actionrefill
orderTilauksen ID. Tai orders: useita pilkulla erotettuina

Vastaus, yksi tilaus

{ "refill": "23501" }

Vastaus, useita

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametriKuvaus
keyAPI-avaimesi
actionrefill_status
refillTäydennyksen ID. Tai refills: useita pilkulla erotettuina

Vastaus

{ "status": "Completed" }

Mitä reitti tekee tilaukselle

  • Vaiheita kokeillaan omassa järjestyksessäsi tai edullisin toimiva ensin. Valitset tavan reitin asetuksissa.
  • Vaihe ohitetaan, kun sen paneeli ei vastaa, sen saldo tai päiväraja ei riitä tilaukseen, määrä on sen hyväksymien rajojen ulkopuolella, sen hinta ylittää asettamasi rajan tai sen hinnalla tilaus ylittäisi reitin oman päivärajan. Vaihe palaa itsestään.
  • Vaihe poistuu käytöstä, kun sen palvelu poistuu hinnastosta tai paneeli alkaa myydä samalla ID:llä jotain muuta. Muut vaiheet jatkavat toimintaansa, ja saat ilmoituksen.
  • Kieltäytyminen siirtää tilauksen eteenpäin. Kun paneeli vastaa ja kieltäytyy, mitään ei veloitettu, joten seuraavaa vaihetta kokeillaan.
  • Epäselvä vastaus pysäyttää sen. Aikakatkaisu tai rikkinäinen vastaus ei kerro, onko tilaus olemassa. Sen lähettäminen eteenpäin voisi toimittaa ja veloittaa sen kahdesti, joten reitti pysähtyy, ja tarkistat kyseisen tilauksen tililläsi.
  • Yksi käynnissä oleva tilaus linkkiä kohden. Kun reitillä on käynnissä tilaus linkille, toinen tilaus samalle linkille hylätään, kuten toimittajat itsekin tekevät.
  • Myös ennen toimitusta tehty peruutus voi siirtyä eteenpäin, jos otit sen käyttöön. Osittaisen tilauksen toimittamatta jäänyt osa siirtyy eteenpäin vain, jos pyysit sitä.

Virheet

VirheMitä se tarkoittaa
Invalid API keyAvain on väärä, vaihdettu tai mitätöity.
This key is limited to certain addresses…Pyyntö tuli osoitteesta, joka ei ole avaimen luettelossa.
Incorrect requestTuntematon action.
Incorrect service IDSinulla ei ole reittiä tällä ID:llä. Poistamasi reitti säilyttää numeronsa, eikä sitä koskaan anneta toiselle.
Incorrect order IDSinulla ei ole tilausta tällä numerolla.
Link is required, Quantity is requiredJokin kentistä add puuttuu tai ei ole numero.
A route takes a link and a quantity onlyPyynnössä oli vaiheittainen toimitus, kommentteja tai muu lisäkenttä.
This route is switched offOta se käyttöön tililläsi.
This route already has an order for this link…Odota, kunnes käynnissä oleva tilaus on valmis.
No step of this route can take this order right now. …Kaikki vaiheet ohitettiin ennen kuin mitään lähetettiin. Tekstissä mainitaan jokainen paneeli ja sen syy.
No step of this route accepted the order. …Kaikki kysytyt vaiheet kieltäytyivät. Mitään ei veloitettu.
Too many requests…Alla olevan rajan yli. Odota minuutti.

Esimerkit

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

Pyyntöön add vastataan aina 30 sekunnin kuluessa. Reitti voi kysyä useilta toimittajilta peräkkäin; kukin saa sen, mitä ajasta on jäljellä, eikä toimittajalta, jota ei ehditä odottaa, kysytä lainkaan. Jos viimeisin kysytty ei ole vastannut ajan päättyessä, saat tilausnumeron tilassa Pending, ja reitti pysähtyy siihen, kunnes vastaus tiedetään. Useimpiin tilauksiin vastataan sekunnissa tai kahdessa.

Rajat ja turvallisuus

  • 300 pyyntöä minuutissa avainta kohden, joista 120 tilauksia. Enintään 100 tilaustunnusta yhdessä status pyyntö.
  • Avain näytetään kerran ja säilytetään sormenjälkenä. Sitä ei voi lukea uudelleen – et sinä emmekä me. Sen vaihtaminen poistaa vanhan heti käytöstä.
  • Sallitut osoitteet. Lisää paneelisi palvelimen osoite tilillesi, niin avain ei toimi mistään muualta.
  • Reitin ID ei ole salaisuus, eikä sen tarvitse olla. Se toimii vain yhdessä reitin omistavan tilin avaimen kanssa.
  • Rajasi ovat edelleen voimassa. Kunkin paneelin päiväraja, reitin oma päiväraja ja sen suurin tilaus koskevat API:n kautta saapuvia tilauksia täsmälleen samoin kuin käsin tekemiäsi.
  • Raha ei koskaan kulje smm.guiden kautta. Jokainen tilaus maksetaan saldostasi siinä paneelissa, joka ottaa sen. Hyvitykset ja riidat jäävät sinun ja kyseisen paneelin välisiksi.

Haluatko lukea luetteloa?

Paneeleilla, Trust Scoreilla ja ajantasaisilla hinnoilla on oma API:nsa sekä MCP-palvelin avustajille.