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.

1Skapa en ruttKonto, Orders desk, Rutter. Välj vad den levererar och lägg till upp till fem tjänster av den typen från panelerna som du har anslutit.
2Skapa nyckelnOrders desk, Orders API. Nyckeln visas en gång. Du kan begränsa den till adressen för din panels server.
3Lägg till en leverantör i din panelAPI-URL 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-metodPOST
API-URLhttps://smm.guide/api/v2
Bodyapplication/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
SvarJSON, 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": "…"}
PengarAmerikanska 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.

ParameterBeskrivning
keyDin API-nyckel
actionservices

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

ParameterBeskrivning
keyDin API-nyckel
actionadd
serviceRuttens ID, åtta siffror
linkLä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

ParameterBeskrivning
keyDin API-nyckel
actionstatus
orderBeställnings-ID

Svar

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterBeskrivning
keyDin API-nyckel
actionstatus
ordersBestä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" }
}
StatusBetydelse
PendingAccepterad 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, ProcessingEn leverantör levererar den, eller så är beställningen på väg till nästa steg.
CompletedHelt levererad.
PartialDelvis 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.
CanceledInget 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.

ParameterBeskrivning
keyDin API-nyckel
actionbalance

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.

ParameterBeskrivning
keyDin API-nyckel
actioncancel
ordersBestä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.

ParameterBeskrivning
keyDin API-nyckel
actionrefill
orderBeställnings-ID. Eller orders: flera, åtskilda med kommatecken

Svar, en beställning

{ "refill": "23501" }

Svar, flera

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterBeskrivning
keyDin API-nyckel
actionrefill_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

FelVad det betyder
Invalid API keyNyckeln ä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 requestOkänd action.
Incorrect service IDIngen 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 IDIngen av dina beställningar har det här numret.
Link is required, Quantity is requiredEtt fält i add saknas eller är inte ett nummer.
A route takes a link and a quantity onlyFörfrågan innehöll gradvis leverans, kommentarer eller ett annat extra fält.
This route is switched offAktivera 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 status anrop.
  • 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.