Hjem / Utviklere / Orders API

Orders API

Legg til smm.guide i panelet ditt som leverandør. Hver rute du lager i kontoen din, er en tjeneste med sin egen ID: panelet ditt sender en bestilling til den ID-en, og ruten sender den videre til den første av leverandørene dine som kan ta den.

Tre trinn

Formatet er det SMM-paneler allerede bruker seg imellom, så det er ingenting å programmere.

1Lag en ruteKonto, Orders desk, Ruter. Velg hva den leverer, og legg til opptil fem tjenester av den typen fra panelene du har koblet til.
2Opprett nøkkelenOrders desk, Orders API. Nøkkelen vises én gang. Du kan begrense den til adressen til panelserveren din.
3Legg til en leverandør i panelet dittAPI-URL https://smm.guide/api/v2 og nøkkelen. Importer tjenestene: rutene dine kommer inn med ID-er, priser og grenser.

Forespørselsformat

HTTP-metodePOST
API-URLhttps://smm.guide/api/v2
Bodyapplication/x-www-form-urlencoded, eller JSON med Content-Type: application/json. A multipart/form-data body leses også, som er det PHP sender når cURL får en matrise
SvarJSON, alltid med HTTP 200, også for en body vi ikke kan lese eller en forespørsel som er for stor. En feil er {"error": "…"}
PengerAmerikanske dollar. Prisene er per 1 000

Tjenesteliste

Rutene dine som kan ta en bestilling akkurat nå. En rute som er slått av, eller der alle trinnene er ute, vises ikke.

ParameterBeskrivelse
keyAPI-nøkkelen din
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 er det dyreste av rutens trinn som kan ta en bestilling, inkludert de som hoppes over for øyeblikket (et panel som er nede i dag, er tilbake i morgen), så en bestilling koster aldri mer enn prisen panelet ditt importerte. min og max er de videste grensene de fungerende trinnene dekker til sammen; et antall som bare passer noen av dem, går til et av disse. refill og cancel er true når hvert slikt trinn tilbyr dem.

En rute som er slått av, eller som ikke har noe trinn som kan fungere, utelates fra denne listen til den er tilbake. Et panel som synkroniserer tjenestene sine automatisk, slår av den tjenesten hos seg i samme tidsrom, og det er det du vil: bestillingene ville blitt avvist.

Legg til bestilling

ParameterBeskrivelse
keyAPI-nøkkelen din
actionadd
serviceRutens ID, åtte sifre
linkLenke til siden, innlegget eller profilen
quantityØnsket antall

Svar

{
  "order": 23501
}

Ingen tok imot den

{
  "error": "No step of this route accepted the order. …"
}

Ordrenummeret er det samme gjennom hele bestillingens levetid, uansett hvilken leverandør som til slutt leverer den. En rute tar en lenke og et antall; gradvis levering, kommentarer og andre ekstrafelt avvises.

Ordrestatus

ParameterBeskrivelse
keyAPI-nøkkelen din
actionstatus
orderOrdre-ID

Svar

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterBeskrivelse
keyAPI-nøkkelen din
actionstatus
ordersOrdre-ID-er atskilt med komma, opptil 100

Svar

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusBetydning
PendingGodtatt av en leverandør og ikke startet ennå. Også en bestilling der en leverandør ikke ga et klart svar: ruten stopper der til du har sjekket den i kontoen din.
In progress, ProcessingEn leverandør leverer den, eller bestillingen er på vei til neste trinn.
CompletedLevert i sin helhet.
PartialDelvis levert; remains er det som ikke ble levert. Det teller det alle trinnene leverte: når ett trinn leverte en del og resten ble kansellert på det neste, er bestillingen Delvis, ikke Kansellert. Leverandøren avgjør om resten av beløpet returneres.
CanceledIngenting ble levert, og ingen andre trinn tok bestillingen. charge viser hva som eventuelt forble trukket.

charge er det leverandørene tok betalt for denne bestillingen, i dollar etter kursen den dagen den ble lagt inn. start_count kommer fra leverandøren som startet den.

Saldo

smm.guide holder ingen av pengene dine. Tallet er summen av saldoene dine på panelene bak rutene dine, i dollar.

ParameterBeskrivelse
keyAPI-nøkkelen din
actionbalance

Svar

{
  "balance": "126.1375",
  "currency": "USD"
}

Avbryt

Sendes til leverandøren som har bestillingen nå, hvis tjenesten tilbyr kansellering. En bestilling du kansellerer, sendes aldri videre til neste trinn.

ParameterBeskrivelse
keyAPI-nøkkelen din
actioncancel
ordersOrdre-ID-er atskilt med komma, opptil 100

Svar

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

Etterfylling

Sendes til leverandøren som leverte bestillingen. Etterfyllingen har bestillingens eget nummer.

ParameterBeskrivelse
keyAPI-nøkkelen din
actionrefill
orderOrdre-ID. Eller orders: flere, atskilt med komma

Svar, én bestilling

{ "refill": "23501" }

Svar, flere

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterBeskrivelse
keyAPI-nøkkelen din
actionrefill_status
refillEtterfyllings-ID. Eller refills: flere, atskilt med komma

Svar

{ "status": "Completed" }

Hva en rute gjør med en bestilling

  • Trinnene prøves i din rekkefølge, eller det billigste fungerende først. Du velger hvilken i ruten.
  • Et trinn hoppes over når panelet ikke svarer, saldoen eller dagsgrensen ikke dekker bestillingen, antallet er utenfor det trinnet tar, prisen er over grensen du har satt, eller bestillingen til den prisen ville gått over rutens egen dagsgrense. Det kommer tilbake av seg selv.
  • Et trinn faller ut når tjenesten forsvinner fra prislisten, eller panelet begynner å selge noe annet under samme ID. De andre trinnene fortsetter å fungere, og du får beskjed.
  • Et avslag sender bestillingen videre. Når et panel svarer og avslår, er ingenting trukket, så neste trinn prøves.
  • Uklart svar stopper den. Et tidsavbrudd eller et ødelagt svar sier ikke om bestillingen finnes. Å sende den videre kan levere og belaste den to ganger, så ruten stopper, og du sjekker den ene bestillingen i kontoen din.
  • Én aktiv bestilling per lenke. Mens en bestilling for en lenke kjører på en rute, avvises en ny for samme lenke, slik leverandørene selv gjør.
  • En kansellering før levering kan også gå videre, hvis du har slått det på. Det en delvis bestilling ikke leverte, går bare videre hvis du har bedt om det.

Feil

FeilHva det betyr
Invalid API keyNøkkelen er feil, erstattet eller tilbakekalt.
This key is limited to certain addresses…Forespørselen kom fra en adresse som ikke står på nøkkelens liste.
Incorrect requestUkjent action.
Incorrect service IDIngen av rutene dine har denne ID-en. En rute du har slettet, beholder nummeret sitt, og det gis aldri til en annen.
Incorrect order IDIngen av bestillingene dine har dette nummeret.
Link is required, Quantity is requiredEt felt i add mangler eller er ikke et tall.
A route takes a link and a quantity onlyForespørselen inneholdt gradvis levering, kommentarer eller et annet ekstrafelt.
This route is switched offSlå det på i kontoen din.
This route already has an order for this link…Vent til den som kjører, er ferdig.
No step of this route can take this order right now. …Alle trinn ble hoppet over før noe ble sendt. Teksten nevner hvert panel og årsaken.
No step of this route accepted the order. …Alle trinn som ble spurt, avslo. Ingenting ble trukket.
Too many requests…Over grensen nedenfor. Vent ett minutt.

Eksempler

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]);

Et add besvares alltid innen 30 sekunder. En rute kan spørre flere leverandører etter hverandre; hver får det som er igjen av den tiden, og en leverandør det ikke er tid til å vente på, blir ikke spurt i det hele tatt. Hvis den siste som ble spurt, ikke har svart når tiden er ute, får du et ordrenummer med statusen Venter, og ruten stopper der til svaret er kjent. De fleste bestillinger besvares på ett eller to sekunder.

Grenser og sikkerhet

  • 300 forespørsler i minuttet per nøkkel, 120 av dem bestillinger. Opptil 100 ordre-ID-er i én status kall.
  • Nøkkelen vises én gang og lagres som et fingeravtrykk. Verken du eller vi kan lese den igjen. Når du erstatter den, slås den gamle av umiddelbart.
  • Tillatte adresser. Oppgi adressen til panelserveren din i kontoen din, så fungerer nøkkelen ikke fra noe annet sted.
  • En rute-ID er ikke en hemmelighet og trenger ikke å være det. Den fungerer bare sammen med nøkkelen til kontoen som eier ruten.
  • Grensene dine gjelder fortsatt. Dagsgrensen for hvert panel, rutens egen dagsgrense og største bestilling gjelder for bestillinger som kommer via API-et, akkurat som for dem du legger inn manuelt.
  • Penger går aldri gjennom smm.guide. Hver bestilling betales fra saldoen din på panelet som tar den. Refusjoner og tvister er mellom deg og det panelet.

Vil du heller lese katalogen?

Paneler, Trust Score og sanntidspriser har et eget API, og en MCP-server for assistenter.