Tryck på Starta / Utvecklare / Orders API
Orders API
Lägg till smm.guide som leverantör i din panel. Varje rutt som du skapar i ditt konto är en tjänst med ett eget ID: din panel skickar en beställning till det ID:t, och rutten skickar den vidare till den första av dina leverantörer som kan ta emot den.
Tre steg
Formatet är detsamma som SMM-paneler redan använder sinsemellan, så det finns inget att programmera.
https://smm.guide/api/v2 och nyckeln. Importera tjänsterna: dina rutter kommer in med sina ID:n, priser och gränser.Förfrågningsformat
| HTTP-metod | POST |
| API-URL | https://smm.guide/api/v2 |
| Body | application/x-www-form-urlencoded, eller JSON med Content-Type: application/json. A multipart/form-data body läses också, vilket är vad PHP skickar när cURL får en array |
| Svar | JSON, alltid med HTTP 200, även för en body som vi inte kan läsa eller en förfrågan som är för stor. Ett fel är {"error": "…"} |
| Pengar | Amerikanska dollar. Priserna gäller per 1 000 |
Tjänstelista
Dina rutter som kan ta emot en beställning just nu. En rutt som är avstängd, eller vars alla steg är ur drift, listas inte.
| Parameter | Beskrivning |
|---|---|
key | Din API-nyckel |
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 är det dyraste av ruttens steg som kan ta emot en beställning, inklusive de som tillfälligt hoppas över (en panel som ligger nere i dag är tillbaka i morgon), så att en beställning aldrig kostar mer än priset som din panel importerade. min och max är det bredaste intervall som de fungerande stegen tillsammans täcker; ett antal som bara passar några av dem går till ett av dessa. refill och cancel är true när varje sådant steg erbjuder dem.
En rutt som är avstängd, eller som inte har något steg som kan fungera, utelämnas från listan tills den är tillbaka. En panel som synkar sina tjänster automatiskt stänger av den tjänsten på sin sida under samma tid, och det är vad du vill: dess beställningar skulle annars avvisas.
Lägg till beställning
| Parameter | Beskrivning |
|---|---|
key | Din API-nyckel |
action | add |
service | Ruttens ID, åtta siffror |
link | Länk till sidan, inlägget eller profilen |
quantity | Önskat antal |
Svar
{
"order": 23501
}
Ingen tog emot den
{
"error": "No step of this route accepted the order. …"
}Beställningsnumret förblir detsamma under beställningens hela livstid, oavsett vilken leverantör som till slut levererar den. En rutt tar emot en länk och ett antal; gradvis leverans, kommentarer och andra extra fält avvisas.
Beställningsstatus
| Parameter | Beskrivning |
|---|---|
key | Din API-nyckel |
action | status |
order | Beställnings-ID |
Svar
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Beskrivning |
|---|---|
key | Din API-nyckel |
action | status |
orders | Beställnings-ID:n åtskilda med kommatecken, upp till 100 |
Svar
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Status | Betydelse |
|---|---|
Pending | Accepterad av en leverantör och inte startad än. Även en beställning där en leverantör inte gav något tydligt svar: rutten stannar där tills du har kontrollerat den i ditt konto. |
In progress, Processing | En leverantör levererar den, eller så är beställningen på väg till nästa steg. |
Completed | Helt levererad. |
Partial | Delvis levererad; remains är det som inte levererades. Det räknar vad varje steg levererade: när ett steg levererade en del och resten avbröts i nästa är beställningen Partial, inte Canceled. Leverantören beslutar om resten av debiteringen återbetalas. |
Canceled | Inget levererades, och inget annat steg tog emot beställningen. charge visar vad som eventuellt förblev debiterat. |
charge är vad leverantörerna debiterade för den här beställningen, i dollar enligt kursen den dag den lades. start_count kommer från leverantören som startade den.
Saldo
smm.guide håller inga pengar åt dig. Siffran är summan av dina saldon på panelerna bakom dina rutter, i dollar.
| Parameter | Beskrivning |
|---|---|
key | Din API-nyckel |
action | balance |
Svar
{
"balance": "126.1375",
"currency": "USD"
}Avbryt
Skickas till leverantören som har beställningen nu, om dess tjänst erbjuder avbrott. En beställning som du avbryter skickas aldrig vidare till nästa steg.
| Parameter | Beskrivning |
|---|---|
key | Din API-nyckel |
action | cancel |
orders | Beställnings-ID:n åtskilda med kommatecken, upp till 100 |
Svar
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Återfyllning
Skickas till leverantören som levererade beställningen. Återfyllningen bär beställningens eget nummer.
| Parameter | Beskrivning |
|---|---|
key | Din API-nyckel |
action | refill |
order | Beställnings-ID. Eller orders: flera, åtskilda med kommatecken |
Svar, en beställning
{ "refill": "23501" }
Svar, flera
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Beskrivning |
|---|---|
key | Din API-nyckel |
action | refill_status |
refill | Återfyllnings-ID. Eller refills: flera, åtskilda med kommatecken |
Svar
{ "status": "Completed" }Vad en rutt gör med en beställning
- Stegen provas i din ordning, eller det billigaste fungerande först. Du väljer vilket i rutten.
- Ett steg hoppas över när dess panel inte svarar, dess saldo eller dagsgräns inte täcker beställningen, antalet ligger utanför vad den tar emot, dess pris är över gränsen du har satt, eller när beställningen till dess pris skulle överskrida ruttens egen dagsgräns. Det kommer tillbaka av sig självt.
- Ett steg tas ur drift när dess tjänst försvinner från prislistan, eller när panelen börjar sälja något annat under samma ID. De andra stegen fortsätter att fungera, och du får besked.
- Ett nej skickar beställningen vidare. När en panel svarar och nekar har inget debiterats, så nästa steg provas.
- Inget tydligt svar stoppar den. En timeout eller ett trasigt svar säger inte om beställningen finns. Om den skickas vidare kan den levereras och debiteras två gånger, så rutten stannar och du kontrollerar just den beställningen i ditt konto.
- En pågående beställning per länk. Medan en beställning för en länk pågår i en rutt avvisas en andra för samma länk, precis som leverantörerna själva gör.
- Ett avbrott före leverans kan också gå vidare, om du har aktiverat det. Det som en delvis levererad beställning lämnade olevererat går bara vidare om du har bett om det.
Fel
| Fel | Vad det betyder |
|---|---|
Invalid API key | Nyckeln är fel, ersatt eller återkallad. |
This key is limited to certain addresses… | Förfrågan kom från en adress som inte finns på nyckelns lista. |
Incorrect request | Okänd action. |
Incorrect service ID | Ingen av dina rutter har det här ID:t. En rutt som du har raderat behåller sitt nummer, och det ges aldrig till någon annan. |
Incorrect order ID | Ingen av dina beställningar har det här numret. |
Link is required, Quantity is required | Ett fält i add saknas eller är inte ett nummer. |
A route takes a link and a quantity only | Förfrågan innehöll gradvis leverans, kommentarer eller ett annat extra fält. |
This route is switched off | Aktivera det i ditt konto. |
This route already has an order for this link… | Vänta tills den pågående är klar. |
No step of this route can take this order right now. … | Varje steg hoppades över innan något skickades. Texten anger varje panel och dess orsak. |
No step of this route accepted the order. … | Varje steg som tillfrågades nekade. Inget debiterades. |
Too many requests… | Över gränsen nedan. Vänta en minut. |
Exempel
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]);
Ett anrop till add besvaras alltid inom 30 sekunder. En rutt kan fråga flera leverantörer efter varandra; var och en får det som återstår av den tiden, och en leverantör som det inte går att vänta på tillfrågas inte alls. Om den sista som tillfrågades inte har svarat när tiden är ute får du ett beställningsnummer med statusen Pending, och rutten stannar där tills svaret är känt. De flesta beställningar besvaras på en eller två sekunder.
Gränser och säkerhet
- 300 förfrågningar per minut och nyckel, varav 120 beställningar. Upp till 100 beställnings-ID:n i ett
statusanrop. - Nyckeln visas en gång och sparas som ett fingeravtryck. Varken du eller vi kan läsa den igen. När du ersätter den stängs den gamla av direkt.
- Tillåtna adresser. Ange din panelservers adress i ditt konto, så fungerar nyckeln inte från något annat ställe.
- Ett rutt-ID är ingen hemlighet och behöver inte vara det. Det fungerar bara tillsammans med nyckeln för kontot som äger rutten.
- Dina gränser gäller fortfarande. Varje panels dagsgräns, ruttens egen dagsgräns och dess största beställning gäller för beställningar som kommer via API:t precis som för dem du lägger manuellt.
- Pengar passerar aldrig genom smm.guide. Varje beställning betalas från ditt saldo på panelen som tar emot den. Återbetalningar och tvister stannar mellan dig och den panelen.
Vill du läsa katalogen i stället?
Paneler, Trust Score och aktuella priser har ett eget API, och en MCP-server för assistenter.