Domov / Za razvijalce / Orders API
Orders API
Dodajte smm.guide v svoj panel kot ponudnika. Vsaka pot, ki jo ustvarite v svojem računu, je storitev z lastnim ID-jem: vaš panel pošlje naročilo na ta ID, pot pa ga preda prvemu od vaših ponudnikov, ki ga lahko prevzame.
Trije koraki
Oblika je ista, ki jo SMM-paneli že uporabljajo med seboj, zato ni treba ničesar programirati.
https://smm.guide/api/v2 in ključ. Uvozite storitve: vaše poti pridejo s svojimi ID-ji, cenami in omejitvami.Oblika zahteve
| Metoda HTTP | POST |
| URL API-ja | https://smm.guide/api/v2 |
| Telo | application/x-www-form-urlencoded, ali JSON z Content-Type: application/json. A multipart/form-data telo se prav tako prebere, kar pošlje PHP, ko cURL prejme polje |
| Odgovor | JSON, vedno s HTTP 200, tudi za telo, ki ga ne moremo prebrati, ali za prevelik zahtevek. Napaka je {"error": "…"} |
| Denar | Ameriški dolarji. Cene so na 1.000 |
Seznam storitev
Vaše poti, ki lahko ta trenutek prevzamejo naročilo. Pot, ki je izklopljena ali so vsi njeni koraki izključeni, ni navedena.
| Parameter | Opis |
|---|---|
key | Vaš ključ API |
action | services |
Odgovor
[
{
"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 je najdražji od korakov poti, ki lahko prevzamejo naročilo, vključno s trenutno preskočenimi (panel, ki danes ne deluje, je jutri spet na voljo), zato naročilo nikoli ne stane več od cene, ki jo je uvozil vaš panel. min in max sta najširši meji, ki ju skupaj pokrivajo delujoči koraki; količina, ki ustreza le nekaterim od njih, gre na enega od teh. refill in cancel sta true, ko ju ponuja vsak tak korak.
Pot, ki je izklopljena ali nima nobenega koraka, ki bi lahko deloval, je s tega seznama izpuščena, dokler se ne vrne. Panel, ki storitve sinhronizira samodejno, bo za isti čas pri sebi izklopil to storitev, kar je prav: njena naročila bi bila zavrnjena.
Dodaj naročilo
| Parameter | Opis |
|---|---|
key | Vaš ključ API |
action | add |
service | ID poti, osem števk |
link | Povezava do strani, objave ali profila |
quantity | Potrebna količina |
Odgovor
{
"order": 23501
}
Nihče ga ni sprejel
{
"error": "No step of this route accepted the order. …"
}Številka naročila ostane enaka ves čas trajanja naročila, ne glede na to, kateri ponudnik ga na koncu izvede. Pot sprejme povezavo in količino; postopno dodajanje, komentarji in druga dodatna polja so zavrnjeni.
Status naročila
| Parameter | Opis |
|---|---|
key | Vaš ključ API |
action | status |
order | ID naročila |
Odgovor
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Opis |
|---|---|
key | Vaš ključ API |
action | status |
orders | ID-ji naročil, ločeni z vejico, največ 100 |
Odgovor
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Status | Pomen |
|---|---|
Pending | Sprejel ga je ponudnik, a se še ni začelo. Tudi naročilo, pri katerem ponudnik ni dal jasnega odgovora: pot se tam ustavi, dokler ga ne preverite v svojem računu. |
In progress, Processing | Ponudnik ga izvaja ali pa je naročilo na poti do naslednjega koraka. |
Completed | Izvedeno v celoti. |
Partial | Delno izvedeno; remains je količina, ki ni bila izvedena. Šteje, kar so izvedli vsi koraki: ko je en korak izvedel del, preostanek pa je bil preklican na naslednjem, je naročilo Partial, ne Canceled. O vračilu preostanka bremenitve odloča ponudnik. |
Canceled | Nič ni bilo izvedeno in noben drug korak ni prevzel naročila. charge pokaže, kaj je, če sploh kaj, ostalo zaračunano. |
charge je znesek, ki so ga ponudniki zaračunali za to naročilo, v dolarjih po tečaju dneva oddaje. start_count pride od ponudnika, ki ga je začel.
Stanje
smm.guide ne hrani vašega denarja. Številka je vsota vaših stanj na panelih za vašimi potmi, v dolarjih.
| Parameter | Opis |
|---|---|
key | Vaš ključ API |
action | balance |
Odgovor
{
"balance": "126.1375",
"currency": "USD"
}Prekliči
Posreduje se ponudniku, ki ima naročilo zdaj, če njegova storitev omogoča preklic. Naročilo, ki ga prekličete, se nikoli ne pošlje naprej na naslednji korak.
| Parameter | Opis |
|---|---|
key | Vaš ključ API |
action | cancel |
orders | ID-ji naročil, ločeni z vejico, največ 100 |
Odgovor
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Dopolnitev
Posreduje se ponudniku, ki je naročilo izvedel. Dopolnitev uporablja številko samega naročila.
| Parameter | Opis |
|---|---|
key | Vaš ključ API |
action | refill |
order | ID naročila. Ali orders: več, ločenih z vejico |
Odgovor, eno naročilo
{ "refill": "23501" }
Odgovor, več naročil
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Opis |
|---|---|
key | Vaš ključ API |
action | refill_status |
refill | ID dopolnitve. Ali refills: več, ločenih z vejico |
Odgovor
{ "status": "Completed" }Kaj pot naredi z naročilom
- Koraki se preizkušajo v vašem vrstnem redu ali najprej najcenejši delujoči. Kaj od tega, izberete v poti.
- Korak se preskoči, ko se njegov panel ne odziva, njegovo stanje ali dnevna omejitev ne pokrije naročila, je količina zunaj obsega, ki ga sprejme, je njegova cena nad omejitvijo, ki ste jo nastavili, ali bi naročilo po njegovi ceni preseglo dnevno omejitev poti. Vrne se sam.
- Korak izpade, ko njegova storitev izgine s cenika ali panel pod istim ID-jem začne prodajati nekaj drugega. Drugi koraki delujejo naprej, vi pa ste obveščeni.
- Zavrnitev premakne naročilo naprej. Ko panel odgovori in zavrne, ni bilo nič zaračunano, zato se preizkusi naslednji korak.
- Nejasen odgovor ga ustavi. Časovna omejitev ali pokvarjen odgovor ne pove, ali naročilo obstaja. Pošiljanje naprej bi ga lahko izvedlo in zaračunalo dvakrat, zato se pot ustavi, vi pa to naročilo preverite v svojem računu.
- Eno aktivno naročilo na povezavo. Dokler na poti teče naročilo za povezavo, je drugo naročilo za isto povezavo zavrnjeno, tako kot to počnejo ponudniki sami.
- Tudi preklic pred izvedbo se lahko premakne naprej, če ste to vklopili. Kar delno naročilo ni izvedlo, se premakne naprej le, če ste to zahtevali.
Napake
| Napaka | Kaj pomeni |
|---|---|
Invalid API key | Ključ je napačen, zamenjan ali preklican. |
This key is limited to certain addresses… | Zahteva je prišla z naslova, ki ni na seznamu ključa. |
Incorrect request | Neznano action. |
Incorrect service ID | Nobena vaša pot nima tega ID-ja. Izbrisana pot obdrži svojo številko, ki ni nikoli dodeljena drugi. |
Incorrect order ID | Nobeno vaše naročilo nima te številke. |
Link is required, Quantity is required | Polje add manjka ali ni število. |
A route takes a link and a quantity only | Zahteva je vsebovala postopno dodajanje, komentarje ali drugo dodatno polje. |
This route is switched off | Vklopite to v svojem računu. |
This route already has an order for this link… | Počakajte, da se aktivno naročilo konča. |
No step of this route can take this order right now. … | Vsi koraki so bili preskočeni, preden je bilo karkoli poslano. Besedilo navaja vsak panel in njegov razlog. |
No step of this route accepted the order. … | Vsi vprašani koraki so zavrnili. Nič ni bilo zaračunano. |
Too many requests… | Presežena je spodaj navedena omejitev. Počakajte minuto. |
Primeri
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]);
Na add odgovorimo vedno v 30 sekundah. Pot lahko vpraša več ponudnikov enega za drugim; vsak dobi preostanek tega časa, ponudnika, na katerega ni mogoče počakati, pa sploh ne vpraša. Če zadnji vprašani ob izteku časa ni odgovoril, prejmete številko naročila s statusom Pending, pot pa se tam ustavi, dokler odgovor ni znan. Na večino naročil je odgovor v sekundi ali dveh.
Omejitve in varnost
- 300 zahtev na minuto na ključ, od tega 120 naročil. Do 100 ID-jev naročil v eni
statusklic. - Ključ je prikazan samo enkrat in shranjen kot prstni odtis. Ne vi ne mi ga ne moremo znova prebrati. Zamenjava takoj izklopi starega.
- Dovoljeni naslovi. V svojem računu navedite naslov strežnika svojega panela in ključ ne bo deloval nikjer drugje.
- ID poti ni skrivnost in tudi ni treba, da bi bil. Deluje samo skupaj s ključem računa, ki je lastnik poti.
- Vaše omejitve še vedno veljajo. Dnevna omejitev vsakega panela, dnevna omejitev poti in njeno največje naročilo veljajo za naročila, ki pridejo prek API-ja, povsem enako kot za tista, ki jih oddate ročno.
- Denar nikoli ne gre prek smm.guide. Vsako naročilo se plača iz vašega stanja na panelu, ki ga prevzame. Vračila in spori ostanejo med vami in tem panelom.
Želite raje brati katalog?
Paneli, Trust Score in cene v živo imajo svoj API ter strežnik MCP za pomočnike.