Forside / Udviklere / Orders API

Orders API

Tilføj smm.guide til dit panel som udbyder. Hver rute, du opretter på din konto, er en tjeneste med sit eget id: dit panel sender en ordre til det id, og ruten sender den videre til den første af dine udbydere, der kan tage den.

Tre trin

Formatet er det, SMM-paneler allerede bruger indbyrdes, så der er intet at programmere.

1Opret en ruteKonto, Orders desk, Ruter. Vælg, hvad den leverer, og tilføj op til fem tjenester af den type fra de paneler, du har forbundet.
2Opret nøglenOrders desk, Orders API. Nøglen vises én gang. Du kan begrænse den til adressen på dit panels server.
3Tilføj en udbyder i dit panelAPI-URL https://smm.guide/api/v2 og nøglen. Importér tjenesterne: dine ruter kommer ind med deres id'er, priser og grænser.

Forespørgselsformat

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 læses også, hvilket er det, PHP sender, når cURL får et array
SvarJSON, altid med HTTP 200, også for en body, vi ikke kan læse, eller en forespørgsel, der er for stor. En fejl er {"error": "…"}
PengeAmerikanske dollar. Priser er pr. 1.000

Tjenesteliste

Dine ruter, der kan tage en ordre lige nu. En rute, der er slået fra, eller hvor alle trin er ude, vises ikke.

ParameterBeskrivelse
keyDin API-nøgle
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 af rutens trin, der kan tage en ordre, inklusive dem, der springes over i øjeblikket (et panel, der er nede i dag, er tilbage i morgen), så en ordre aldrig koster mere end den pris, dit panel importerede. min og max er de bredeste, som de fungerende trin dækker tilsammen; et antal, der kun passer til nogle af dem, går til et af disse. refill og cancel er sande, når alle sådanne trin tilbyder dem.

En rute, der er slået fra eller ikke har noget trin, der kan fungere, udelades af denne liste, indtil den er tilbage. Et panel, der synkroniserer sine tjenester automatisk, slår den tjeneste fra hos sig selv i samme tidsrum, og det er det, du vil have: dets ordrer ville blive afvist.

Tilføj ordre

ParameterBeskrivelse
keyDin API-nøgle
actionadd
serviceRutens id, otte cifre
linkLink til siden, opslaget eller profilen
quantityØnsket antal

Svar

{
  "order": 23501
}

Ingen accepterede den

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

Ordrenummeret forbliver det samme i hele ordrens levetid, uanset hvilken udbyder der ender med at levere den. En rute tager et link og et antal; drip-feed, kommentarer og andre ekstra felter afvises.

Ordrestatus

ParameterBeskrivelse
keyDin API-nøgle
actionstatus
orderOrdre-id

Svar

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterBeskrivelse
keyDin API-nøgle
actionstatus
ordersOrdre-id'er adskilt af komma, op til 100

Svar

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusBetydning
PendingAccepteret af en udbyder og endnu ikke startet. Også en ordre, hvor en udbyder ikke gav et klart svar: ruten stopper der, indtil du har kontrolleret den på din konto.
In progress, ProcessingEn udbyder leverer den, eller ordren er på vej til næste trin.
CompletedLeveret fuldt ud.
PartialDelvist leveret; remains er det, der ikke blev leveret. Det tæller, hvad hvert trin leverede: når ét trin leverede en del, og resten blev annulleret på det næste, er ordren Delvis, ikke Annulleret. Udbyderen afgør, om resten af beløbet returneres.
CanceledIntet blev leveret, og intet andet trin tog ordren. charge viser, hvad der eventuelt forblev opkrævet.

charge er det, udbyderne opkrævede for denne ordre, i dollar efter kursen på den dag, den blev afgivet. start_count kommer fra den udbyder, der startede den.

Saldo

smm.guide opbevarer ingen af dine penge. Tallet er summen af dine saldi på panelerne bag dine ruter, i dollar.

ParameterBeskrivelse
keyDin API-nøgle
actionbalance

Svar

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

Annuller

Sendes videre til den udbyder, der har ordren nu, hvis dens tjeneste tilbyder annullering. En ordre, du annullerer, sendes aldrig videre til næste trin.

ParameterBeskrivelse
keyDin API-nøgle
actioncancel
ordersOrdre-id'er adskilt af komma, op til 100

Svar

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

Genopfyldning

Sendes videre til den udbyder, der leverede ordren. Genopfyldningen bærer ordrens eget nummer.

ParameterBeskrivelse
keyDin API-nøgle
actionrefill
orderOrdre-id. Eller orders: flere, adskilt af komma

Svar, én ordre

{ "refill": "23501" }

Svar, flere

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterBeskrivelse
keyDin API-nøgle
actionrefill_status
refillGenopfyldnings-id. Eller refills: flere, adskilt af komma

Svar

{ "status": "Completed" }

Hvad en rute gør med en ordre

  • Trinnene prøves i din rækkefølge eller med det billigste fungerende først. Du vælger hvilken i ruten.
  • Et trin springes over, når dets panel ikke svarer, dets saldo eller daglige grænse ikke dækker ordren, antallet ligger uden for det, det tager, dets pris er over den grænse, du har sat, eller ordren til dets pris ville overskride rutens egen daglige grænse. Det kommer selv tilbage.
  • Et trin udgår, når dets tjeneste forsvinder fra prislisten, eller panelet begynder at sælge noget andet under samme id. De andre trin fortsætter, og du får besked.
  • En afvisning sender ordren videre. Når et panel svarer og afviser, er der intet trukket, så det næste trin prøves.
  • Intet klart svar stopper den. En timeout eller et ødelagt svar fortæller ikke, om ordren findes. Hvis den sendes videre, kan den blive leveret og opkrævet to gange, så ruten stopper, og du kontrollerer den ene ordre på din konto.
  • Én aktiv ordre pr. link. Mens en ordre på et link kører på en rute, afvises en ny ordre på samme link, ligesom udbyderne selv gør.
  • En annullering før levering kan også gå videre, hvis du har slået det til. Det, en delvis ordre ikke leverede, går kun videre, hvis du har bedt om det.

Fejl

FejlHvad det betyder
Invalid API keyNøglen er forkert, erstattet eller tilbagekaldt.
This key is limited to certain addresses…Forespørgslen kom fra en adresse, der ikke er på nøglens liste.
Incorrect requestUkendt action.
Incorrect service IDIngen af dine ruter har dette id. En rute, du har slettet, beholder sit nummer, og det gives aldrig til en anden.
Incorrect order IDIngen af dine ordrer har dette nummer.
Link is required, Quantity is requiredEt felt i add mangler eller er ikke et tal.
A route takes a link and a quantity onlyForespørgslen indeholdt drip-feed, kommentarer eller et andet ekstra felt.
This route is switched offSlå det til på din konto.
This route already has an order for this link…Vent, til den kørende er færdig.
No step of this route can take this order right now. …Alle trin blev sprunget over, før noget blev sendt. Teksten nævner hvert panel og årsagen.
No step of this route accepted the order. …Alle trin, der blev spurgt, afviste. Intet blev trukket.
Too many requests…Over grænsen nedenfor. Vent et minut.

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 kald til add besvares altid inden for 30 sekunder. En rute kan spørge flere udbydere efter hinanden; hver får det, der er tilbage af den tid, og en udbyder, der ikke kan nå at svare, bliver slet ikke spurgt. Hvis den sidste, der blev spurgt, ikke har svaret, når tiden er gået, får du et ordrenummer med status Pending, og ruten stopper der, indtil svaret kendes. De fleste ordrer besvares på et eller to sekunder.

Grænser og sikkerhed

  • 300 anmodninger i minuttet pr. nøgle, heraf 120 ordrer. Op til 100 ordre-id'er i én status kald.
  • Nøglen vises én gang og gemmes som et fingeraftryk. Hverken du eller vi kan læse den igen. Når du erstatter den, slås den gamle fra med det samme.
  • Tilladte adresser. Angiv din panelservers adresse på din konto, så virker nøglen ingen andre steder fra.
  • Et rute-id er ikke en hemmelighed og behøver ikke at være det. Det virker kun sammen med nøglen fra den konto, der ejer ruten.
  • Dine grænser gælder stadig. Hvert panels daglige grænse, rutens egen daglige grænse og dens største ordre gælder for ordrer, der kommer via API'et, præcis som for dem, du afgiver manuelt.
  • Penge går aldrig gennem smm.guide. Hver ordre betales fra din saldo på det panel, der tager den. Refusioner og tvister forbliver mellem dig og det panel.

Vil du hellere læse kataloget?

Paneler, Trust Scores og aktuelle priser har deres eget API og en MCP-server til assistenter.