Tuis / Ontwikkelaars / Orders API
Orders API
Voeg smm.guide as verskaffer by u paneel. Elke roete wat u in u rekening bou, is ’n diens met sy eie ID: u paneel stuur ’n bestelling na daardie ID, en die roete gee dit aan die eerste van u verskaffers wat dit kan neem.
Drie stappe
Die formaat is dié wat SMM-panele reeds onderling gebruik, so daar is niks om te programmeer nie.
https://smm.guide/api/v2 en die sleutel. Voer die dienste in: u roetes kom aan met hul ID’s, pryse en limiete.Versoekformaat
| HTTP-metode | POST |
| API-URL | https://smm.guide/api/v2 |
| Liggaam | application/x-www-form-urlencoded, of JSON met Content-Type: application/json. A multipart/form-data liggaam word ook gelees, wat PHP stuur wanneer cURL ’n skikking kry |
| Antwoord | JSON, altyd met HTTP 200, ook vir ’n liggaam wat ons nie kan lees nie of ’n versoek wat te groot is. ’n Fout is {"error": "…"} |
| Geld | Amerikaanse dollar. Pryse is per 1 000 |
Dienslys
U roetes wat nou ’n bestelling kan neem. ’n Roete wat afgeskakel is, of waarvan elke stap uit is, word nie gelys nie.
| Parameter | Beskrywing |
|---|---|
key | U API-sleutel |
action | services |
Antwoord
[
{
"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 is die duurste van die roete se stappe wat ’n bestelling kan neem, dié wat tydelik oorgeslaan word ingesluit (’n paneel wat vandag af is, is môre terug), sodat ’n bestelling nooit meer kos as die prys wat u paneel ingevoer het nie. min en max is die wydste wat die werkende stappe saam dek; ’n hoeveelheid wat net by sommige van hulle pas, gaan na een daarvan. refill en cancel is waar wanneer elke sodanige stap dit aanbied.
’n Roete wat afgeskakel is, of geen stap het wat kan werk nie, word uit hierdie lys gelaat totdat dit terug is. ’n Paneel wat sy dienste outomaties sinchroniseer, sal daardie diens vir dieselfde tyd aan sy kant afskakel, en dit is wat u wil hê: sy bestellings sou geweier word.
Voeg bestelling by
| Parameter | Beskrywing |
|---|---|
key | U API-sleutel |
action | add |
service | Die roete se ID, agt syfers |
link | Skakel na die bladsy, plasing of profiel |
quantity | Benodigde hoeveelheid |
Antwoord
{
"order": 23501
}
Niks het dit aanvaar nie
{
"error": "No step of this route accepted the order. …"
}Die bestelnommer bly dieselfde vir die hele leeftyd van die bestelling, watter verskaffer dit ook al uiteindelik lewer. ’n Roete neem ’n skakel en ’n hoeveelheid; geleidelike lewering, kommentaar en ander ekstra velde word geweier.
Bestellingstatus
| Parameter | Beskrywing |
|---|---|
key | U API-sleutel |
action | status |
order | Bestelling-ID |
Antwoord
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Beskrywing |
|---|---|
key | U API-sleutel |
action | status |
orders | Bestelling-ID’s geskei deur ’n komma, tot 100 |
Antwoord
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Status | Betekenis |
|---|---|
Pending | Deur ’n verskaffer aanvaar en nog nie begin nie. Ook ’n bestelling waarop ’n verskaffer geen duidelike antwoord gegee het nie: die roete stop daar totdat u dit in u rekening nagegaan het. |
In progress, Processing | ’n Verskaffer lewer dit, of die bestelling is op pad na die volgende stap. |
Completed | Volledig gelewer. |
Partial | Deels gelewer; remains is wat nie gelewer is nie. Dit tel wat elke stap gelewer het: wanneer een stap ’n deel gelewer het en die res op die volgende gekanselleer is, is die bestelling Partial, nie Canceled nie. Die verskaffer besluit oor die terugbetaling van die res van die koste. |
Canceled | Niks is gelewer nie, en geen ander stap het die bestelling geneem nie. charge wys wat gehef gebly het, as daar iets is. |
charge is wat die verskaffers vir hierdie bestelling gehef het, in dollar teen die koers van die dag waarop dit geplaas is. start_count kom van die verskaffer wat dit begin het.
Saldo
smm.guide hou geen geld van u nie. Die syfer is die som van u saldo’s op die panele agter u roetes, in dollar.
| Parameter | Beskrywing |
|---|---|
key | U API-sleutel |
action | balance |
Antwoord
{
"balance": "126.1375",
"currency": "USD"
}Kanselleer
Word deurgegee aan die verskaffer wat die bestelling nou hou, as sy diens ’n kansellasie aanbied. ’n Bestelling wat u kanselleer, word nooit na die volgende stap aangestuur nie.
| Parameter | Beskrywing |
|---|---|
key | U API-sleutel |
action | cancel |
orders | Bestelling-ID’s geskei deur ’n komma, tot 100 |
Antwoord
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Navulling
Word deurgegee aan die verskaffer wat die bestelling gelewer het. Die navulling dra die bestelling se eie nommer.
| Parameter | Beskrywing |
|---|---|
key | U API-sleutel |
action | refill |
order | Bestelling-ID. Of orders: verskeie, geskei deur ’n komma |
Antwoord, een bestelling
{ "refill": "23501" }
Antwoord, verskeie
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Beskrywing |
|---|---|
key | U API-sleutel |
action | refill_status |
refill | Navulling-ID. Of refills: verskeie, geskei deur ’n komma |
Antwoord
{ "status": "Completed" }Wat ’n roete met ’n bestelling doen
- Die stappe word in u volgorde probeer, of die goedkoopste werkende een eerste. U kies watter in die roete.
- ’n Stap word oorgeslaan wanneer sy paneel nie antwoord nie, sy saldo of daaglikse limiet nie die bestelling dek nie, die hoeveelheid buite sy grense val, sy prys bo die limiet is wat u gestel het, of die bestelling teen sy prys die roete se eie daaglikse limiet sou oorskry. Dit kom vanself terug.
- ’n Stap val uit wanneer sy diens van die pryslys verdwyn, of die paneel iets anders onder dieselfde ID begin verkoop. Die ander stappe werk voort, en u word ingelig.
- ’n Weiering skuif die bestelling aan. Wanneer ’n paneel antwoord en weier, is niks gehef nie, dus word die volgende stap probeer.
- Geen duidelike antwoord stop dit. ’n Uittelling of ’n gebroke antwoord sê nie of die bestelling bestaan nie. Om dit aan te stuur, kan dit twee keer lewer en hef, dus stop die roete en u gaan daardie een bestelling in u rekening na.
- Een lopende bestelling per skakel. Terwyl ’n bestelling vir ’n skakel op ’n roete loop, word ’n tweede een vir dieselfde skakel geweier, soos verskaffers self doen.
- ’n Kansellasie voor lewering kan ook aanbeweeg, as u dit aangeskakel het. Wat ’n gedeeltelike bestelling ongelewer gelaat het, beweeg slegs aan as u daarvoor gevra het.
Foute
| Fout | Wat dit beteken |
|---|---|
Invalid API key | Die sleutel is verkeerd, vervang of herroep. |
This key is limited to certain addresses… | Die versoek het gekom van ’n adres wat nie op die sleutel se lys is nie. |
Incorrect request | Onbekend action. |
Incorrect service ID | Geen roete van u het hierdie ID nie. ’n Roete wat u uitgevee het, behou sy nommer, en dit word nooit aan ’n ander gegee nie. |
Incorrect order ID | Geen bestelling van u het hierdie nommer nie. |
Link is required, Quantity is required | ’n Veld van add ontbreek of is nie ’n getal nie. |
A route takes a link and a quantity only | Die versoek het geleidelike lewering, kommentaar of ’n ander ekstra veld bevat. |
This route is switched off | Skakel dit in u rekening aan. |
This route already has an order for this link… | Wag totdat die lopende een klaar is. |
No step of this route can take this order right now. … | Elke stap is oorgeslaan voordat iets gestuur is. Die teks noem elke paneel en sy rede. |
No step of this route accepted the order. … | Elke stap wat gevra is, het geweier. Niks is gehef nie. |
Too many requests… | Oor die limiet hieronder. Wag ’n minuut. |
Voorbeelde
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]);
’n add word altyd binne 30 sekondes beantwoord. ’n Roete kan verskeie verskaffers na mekaar vra; elkeen kry wat van daardie tyd oor is, en ’n verskaffer vir wie nie gewag kon word nie, word glad nie gevra nie. As die laaste een wat gevra is nie geantwoord het wanneer die tyd om is nie, kry u ’n bestelnommer met die status Pending, en die roete stop daar totdat die antwoord bekend is. Die meeste bestellings word binne een of twee sekondes beantwoord.
Limiete en veiligheid
- 300 versoeke per minuut per sleutel, waarvan 120 bestellings. Tot 100 bestelling-ID’s in een
statusoproep. - Die sleutel word een keer gewys en as ’n vingerafdruk gehou. Nóg u nóg ons kan dit weer lees. As u dit vervang, word die ou een dadelik afgeskakel.
- Toegelate adresse. Lys u paneel se bedieneradres in u rekening, en die sleutel werk van nêrens anders nie.
- ’n Roete-ID is nie ’n geheim nie en hoef nie een te wees nie. Dit werk slegs saam met die sleutel van die rekening wat die roete besit.
- U limiete geld steeds. Die daaglikse limiet van elke paneel, die roete se eie daaglikse limiet en sy grootste bestelling geld vir bestellings wat via die API aankom presies soos vir dié wat u met die hand plaas.
- Geld gaan nooit deur smm.guide nie. Elke bestelling word betaal uit u saldo op die paneel wat dit neem. Terugbetalings en dispute bly tussen u en daardie paneel.
Wil u eerder die katalogus lees?
Panele, Trust Scores en lewendige pryse het ’n eie API, en ’n MCP-bediener vir assistente.