Forsíða / Forritarar / Orders API
Orders API
Bættu smm.guide við spjaldið þitt sem birgi. Hver leið sem þú býrð til í aðganginum þínum er þjónusta með eigið ID: spjaldið þitt sendir pöntun á það ID og leiðin færir hana til fyrsta birgisins þíns sem getur tekið við henni.
Þrjú skref
Sniðið er það sama og SMM-spjöld nota nú þegar sín á milli, svo það er ekkert að forrita.
https://smm.guide/api/v2 og lykilinn. Fluttu inn þjónusturnar: leiðirnar þínar koma inn með ID, verðum og mörkum.Snið beiðna
| HTTP-aðferð | POST |
| API-slóð | https://smm.guide/api/v2 |
| Meginmál | application/x-www-form-urlencoded, eða JSON með Content-Type: application/json. A multipart/form-data meginmál er líka lesið, en það er það sem PHP sendir þegar cURL fær fylki |
| Svar | JSON, alltaf með HTTP 200, líka fyrir meginmál sem við getum ekki lesið eða beiðni sem er of stór. Villa er {"error": "…"} |
| Peningar | Bandaríkjadalir. Verð eru á hver 1.000 |
Þjónustulisti
Leiðirnar þínar sem geta tekið við pöntun núna. Leið sem slökkt er á, eða þar sem öll skref eru úti, er ekki á listanum.
| Færibreyta | Lýsing |
|---|---|
key | API-lykillinn þinn |
action | services |
Svar
[
{
"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 er dýrasta skref leiðarinnar sem gæti tekið við pöntun, að meðtöldum þeim sem er sleppt í bili (spjald sem liggur niðri í dag er komið aftur á morgun), svo pöntun kostar aldrei meira en verðið sem spjaldið þitt flutti inn. min og max eru víðustu mörkin sem virku skrefin ná yfir saman; magn sem passar aðeins við sum þeirra fer til eins þeirra. refill og cancel eru true þegar öll slík skref bjóða upp á þau.
Leið sem slökkt er á, eða hefur ekkert skref sem getur virkað, er haldið utan við þennan lista þar til hún kemur aftur. Spjald sem samstillir þjónustur sínar sjálfkrafa slekkur á þeirri þjónustu sín megin á sama tíma, sem er það sem þú vilt: pöntunum hennar yrði hafnað.
Bæta við pöntun
| Færibreyta | Lýsing |
|---|---|
key | API-lykillinn þinn |
action | add |
service | ID leiðarinnar, átta tölustafir |
link | Tengill á síðu, færslu eða prófíl |
quantity | Magn sem þarf |
Svar
{
"order": 23501
}
Enginn tók við henni
{
"error": "No step of this route accepted the order. …"
}Pöntunarnúmerið helst það sama allan líftíma pöntunarinnar, hvaða birgir sem endar á að afhenda hana. Leið tekur við tengli og magni; dreifðri afhendingu, athugasemdum og öðrum aukareitum er hafnað.
Staða pöntunar
| Færibreyta | Lýsing |
|---|---|
key | API-lykillinn þinn |
action | status |
order | Pöntunar-ID |
Svar
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Færibreyta | Lýsing |
|---|---|
key | API-lykillinn þinn |
action | status |
orders | Pöntunar-ID aðskilin með kommu, allt að 100 |
Svar
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Staða | Merking |
|---|---|
Pending | Birgir hefur tekið við henni en hún er ekki hafin. Einnig pöntun sem birgir gaf ekkert skýrt svar um: leiðin stöðvast þar þangað til þú hefur athugað hana í aðganginum þínum. |
In progress, Processing | Birgir er að afhenda hana eða pöntunin er á leið á næsta skref. |
Completed | Afhent að fullu. |
Partial | Afhent að hluta; remains er það sem var ekki afhent. Það telur það sem öll skref afhentu: þegar eitt skref afhenti hluta og hætt var við afganginn á því næsta er pöntunin Að hluta, ekki Hætt við. Birgirinn ákveður hvort afgangur gjaldsins er endurgreiddur. |
Canceled | Ekkert var afhent og ekkert annað skref tók við pöntuninni. charge sýnir hvað, ef eitthvað, var áfram gjaldfært. |
charge er það sem birgjarnir gjaldfærðu fyrir þessa pöntun, í dölum á gengi dagsins sem hún var lögð inn. start_count kemur frá birginum sem hóf hana.
Inneign
smm.guide geymir enga peninga frá þér. Talan er summa inneigna þinna á spjöldunum á bak við leiðirnar þínar, í dölum.
| Færibreyta | Lýsing |
|---|---|
key | API-lykillinn þinn |
action | balance |
Svar
{
"balance": "126.1375",
"currency": "USD"
}Hætta við
Sent til birgisins sem er með pöntunina núna, ef þjónusta hans býður upp á afturköllun. Pöntun sem þú hættir við er aldrei send áfram á næsta skref.
| Færibreyta | Lýsing |
|---|---|
key | API-lykillinn þinn |
action | cancel |
orders | Pöntunar-ID aðskilin með kommu, allt að 100 |
Svar
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Endurfylling
Sent til birgisins sem afhenti pöntunina. Endurfyllingin ber eigið númer pöntunarinnar.
| Færibreyta | Lýsing |
|---|---|
key | API-lykillinn þinn |
action | refill |
order | Pöntunar-ID. Eða orders: nokkur, aðskilin með kommu |
Svar, ein pöntun
{ "refill": "23501" }
Svar, nokkrar
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Færibreyta | Lýsing |
|---|---|
key | API-lykillinn þinn |
action | refill_status |
refill | Endurfyllingar-ID. Eða refills: nokkur, aðskilin með kommu |
Svar
{ "status": "Completed" }Hvað leið gerir við pöntun
- Skrefin eru reynd í þinni röð, eða ódýrasta virka skrefið fyrst. Þú velur hvort í leiðinni.
- Skrefi er sleppt þegar spjald þess svarar ekki, inneign þess eða daglegt hámark dugar ekki fyrir pöntuninni, magnið er utan þess sem það tekur við, verð þess er yfir hámarkinu sem þú settir, eða pöntunin færi á því verði yfir eigið daglegt hámark leiðarinnar. Það kemur sjálfkrafa aftur.
- Skref dettur út þegar þjónusta þess hverfur af verðskránni eða spjaldið byrjar að selja eitthvað annað undir sama ID. Hin skrefin halda áfram að virka og þér er tilkynnt.
- Höfnun færir pöntunina áfram. Þegar spjald svarar og hafnar var ekkert gjaldfært, svo næsta skref er reynt.
- Óskýrt svar stöðvar hana. Tímamörk eða bilað svar segja ekki til um hvort pöntunin sé til. Ef hún væri send áfram gæti hún verið afhent og gjaldfærð tvisvar, svo leiðin stöðvast og þú athugar þessa einu pöntun í aðganginum þínum.
- Ein virk pöntun á hvern tengil. Á meðan pöntun fyrir tengil er í gangi á leið er annarri pöntun fyrir sama tengil hafnað, eins og birgjar gera sjálfir.
- Afturköllun fyrir afhendingu getur líka færst áfram, ef þú kveiktir á því. Það sem pöntun að hluta skildi eftir óafhent færist aðeins áfram ef þú baðst um það.
Villur
| Villa | Hvað hún þýðir |
|---|---|
Invalid API key | Lykillinn er rangur, honum hefur verið skipt út eða hann afturkallaður. |
This key is limited to certain addresses… | Beiðnin kom frá vistfangi sem er ekki á lista lykilsins. |
Incorrect request | Óþekkt action. |
Incorrect service ID | Engin leið þín hefur þetta ID. Leið sem þú eyddir heldur númeri sínu og það er aldrei gefið annarri. |
Incorrect order ID | Engin pöntun þín hefur þetta númer. |
Link is required, Quantity is required | Reit í add vantar eða hann er ekki tala. |
A route takes a link and a quantity only | Beiðnin innihélt dreifða afhendingu, athugasemdir eða annan aukareit. |
This route is switched off | Kveiktu á því í aðganginum þínum. |
This route already has an order for this link… | Bíddu þar til sú sem er í gangi er búin. |
No step of this route can take this order right now. … | Öllum skrefum var sleppt áður en nokkuð var sent. Textinn nefnir hvert spjald og ástæðuna. |
No step of this route accepted the order. … | Öll skref sem spurð voru höfnuðu. Ekkert var gjaldfært. |
Too many requests… | Yfir mörkunum hér að neðan. Bíddu í mínútu. |
Dæmi
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]);
Köllun á add er alltaf svarað innan 30 sekúndna. Leið getur spurt nokkra birgja hvern á eftir öðrum; hver fær það sem eftir er af þeim tíma og birgir sem ekki væri hægt að bíða eftir er alls ekki spurður. Ef sá síðasti sem spurður var hefur ekki svarað þegar tíminn er úti færðu pöntunarnúmer með stöðunni Í bið og leiðin stöðvast þar þar til svarið liggur fyrir. Flestum pöntunum er svarað á einni eða tveimur sekúndum.
Mörk og öryggi
- 300 beiðnir á mínútu á hvern lykil, þar af 120 pantanir. Allt að 100 pöntunarauðkenni í einu
statusköllun. - Lykillinn er sýndur einu sinni og geymdur sem fingrafar. Hvorki þú né við getum lesið hann aftur. Ef honum er skipt út verður sá gamli óvirkur samstundis.
- Leyfð vistföng. Skráðu vistfang netþjóns spjaldsins þíns í aðganginum og lykillinn virkar hvergi annars staðar.
- ID leiðar er ekki leyndarmál og þarf ekki að vera það. Það virkar aðeins ásamt lykli aðgangsins sem á leiðina.
- Mörkin þín gilda áfram. Daglegt hámark hvers spjalds, eigið daglegt hámark leiðarinnar og stærsta pöntun hennar gilda um pantanir sem berast í gegnum API nákvæmlega eins og um þær sem þú leggur inn handvirkt.
- Peningar fara aldrei í gegnum smm.guide. Hver pöntun er greidd af inneign þinni á spjaldinu sem tekur við henni. Endurgreiðslur og ágreiningur eru á milli þín og þess spjalds.
Viltu frekar lesa skrána?
Spjöld, Trust Score og verð í rauntíma hafa sitt eigið API og MCP-þjón fyrir aðstoðarmenn.