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.
https://smm.guide/api/v2 ja avain. Tuo palvelut: reittisi tulevat ID:ineen, hintoineen ja rajoineen.Pyynnön muoto
| HTTP-metodi | POST |
| API-URL | https://smm.guide/api/v2 |
| Runko | application/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 |
| Vastaus | JSON, aina HTTP 200 -tilakoodilla, myös rungolle, jota emme voi lukea, tai liian suurelle pyynnölle. Virhe on {"error": "…"} |
| Raha | Yhdysvaltain 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.
| Parametri | Kuvaus |
|---|---|
key | API-avaimesi |
action | services |
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
| Parametri | Kuvaus |
|---|---|
key | API-avaimesi |
action | add |
service | Reitin ID, kahdeksan numeroa |
link | Linkki sivuun, julkaisuun tai profiiliin |
quantity | Tarvittava 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
| Parametri | Kuvaus |
|---|---|
key | API-avaimesi |
action | status |
order | Tilauksen ID |
Vastaus
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametri | Kuvaus |
|---|---|
key | API-avaimesi |
action | status |
orders | Tilausten 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" }
}| Tila | Merkitys |
|---|---|
Pending | Toimittaja 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, Processing | Toimittaja toimittaa sitä, tai tilaus on siirtymässä seuraavaan vaiheeseen. |
Completed | Toimitettu kokonaan. |
Partial | Osa 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. |
Canceled | Mitää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.
| Parametri | Kuvaus |
|---|---|
key | API-avaimesi |
action | balance |
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.
| Parametri | Kuvaus |
|---|---|
key | API-avaimesi |
action | cancel |
orders | Tilausten 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.
| Parametri | Kuvaus |
|---|---|
key | API-avaimesi |
action | refill |
order | Tilauksen ID. Tai orders: useita pilkulla erotettuina |
Vastaus, yksi tilaus
{ "refill": "23501" }
Vastaus, useita
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parametri | Kuvaus |
|---|---|
key | API-avaimesi |
action | refill_status |
refill | Tä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
| Virhe | Mitä se tarkoittaa |
|---|---|
Invalid API key | Avain on väärä, vaihdettu tai mitätöity. |
This key is limited to certain addresses… | Pyyntö tuli osoitteesta, joka ei ole avaimen luettelossa. |
Incorrect request | Tuntematon action. |
Incorrect service ID | Sinulla ei ole reittiä tällä ID:llä. Poistamasi reitti säilyttää numeronsa, eikä sitä koskaan anneta toiselle. |
Incorrect order ID | Sinulla ei ole tilausta tällä numerolla. |
Link is required, Quantity is required | Jokin kentistä add puuttuu tai ei ole numero. |
A route takes a link and a quantity only | Pyynnössä oli vaiheittainen toimitus, kommentteja tai muu lisäkenttä. |
This route is switched off | Ota 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ä
statuspyyntö. - 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.