Home / Ontwikkelaars / Orders API

Orders API

Voeg smm.guide als leverancier toe aan je panel. Elke route die je in je account maakt, is een dienst met een eigen ID: je panel stuurt een bestelling naar die ID en de route geeft haar door aan de eerste van je leveranciers die haar kan aannemen.

Drie stappen

Het formaat is hetzelfde dat SMM-panels al onderling gebruiken, dus er hoeft niets te worden geprogrammeerd.

1Maak een routeAccount, Orders desk, Routes. Kies wat de route levert en voeg tot vijf diensten van die soort toe uit de panels die je hebt gekoppeld.
2Maak de sleutel aanOrders desk, Orders API. De sleutel wordt één keer getoond. Je kunt hem beperken tot het adres van de server van je panel.
3Voeg een leverancier toe in je panelAPI-URL https://smm.guide/api/v2 en de sleutel. Importeer de diensten: je routes komen binnen met hun ID's, prijzen en limieten.

Verzoekformaat

HTTP-methodePOST
API-URLhttps://smm.guide/api/v2
Bodyapplication/x-www-form-urlencoded, of JSON met Content-Type: application/json. A multipart/form-data body wordt ook gelezen; dat is wat PHP verstuurt als cURL een array krijgt
AntwoordJSON, altijd met HTTP 200, ook bij een body die we niet kunnen lezen of een verzoek dat te groot is. Een fout is {"error": "…"}
GeldAmerikaanse dollars. Prijzen zijn per 1.000

Dienstenlijst

Je routes die nu een bestelling kunnen aannemen. Een route die is uitgeschakeld, of waarvan elke stap is uitgevallen, staat er niet in.

ParameterBeschrijving
keyJe API-sleutel
actionservices

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 de duurste van de stappen van de route die een bestelling kunnen aannemen, inclusief de stappen die op dit moment worden overgeslagen (een panel dat vandaag plat ligt, is er morgen weer), zodat een bestelling nooit meer kost dan de prijs die je panel heeft geïmporteerd. min en max zijn de ruimste grenzen die de werkende stappen samen hanteren; een aantal dat maar bij sommige ervan past, gaat naar een van die stappen. refill en cancel zijn true wanneer elke stap van dat soort ze aanbiedt.

Een route die is uitgeschakeld of geen stap heeft die kan werken, wordt uit deze lijst weggelaten tot hij terug is. Een panel dat zijn diensten automatisch synchroniseert, schakelt die dienst aan zijn kant voor dezelfde tijd uit, en dat is precies wat je wilt: de bestellingen ervan zouden worden geweigerd.

Bestelling toevoegen

ParameterBeschrijving
keyJe API-sleutel
actionadd
serviceDe ID van de route, acht cijfers
linkLink naar de pagina, post of het profiel
quantityBenodigd aantal

Antwoord

{
  "order": 23501
}

Door niemand aangenomen

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

Het bestelnummer blijft gedurende de hele levensduur van de bestelling hetzelfde, welke leverancier haar uiteindelijk ook levert. Een route neemt een link en een aantal aan; drip-feed, reacties en andere extra velden worden geweigerd.

Bestelstatus

ParameterBeschrijving
keyJe API-sleutel
actionstatus
orderBestel-ID

Antwoord

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterBeschrijving
keyJe API-sleutel
actionstatus
ordersBestel-ID's gescheiden door een komma, maximaal 100

Antwoord

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusBetekenis
PendingAangenomen door een leverancier en nog niet gestart. Ook een bestelling waarop een leverancier geen duidelijk antwoord gaf: de route stopt daar tot je haar in je account hebt gecontroleerd.
In progress, ProcessingEen leverancier levert haar, of de bestelling is onderweg naar de volgende stap.
CompletedVolledig geleverd.
PartialDeels geleverd; remains is wat niet is geleverd. Het telt wat elke stap heeft geleverd: als de ene stap een deel leverde en de rest bij de volgende werd geannuleerd, is de bestelling Gedeeltelijk, niet Geannuleerd. De leverancier beslist over het terugstorten van de rest van de kosten.
CanceledEr is niets geleverd, en geen andere stap heeft de bestelling aangenomen. charge toont wat er eventueel afgeschreven is gebleven.

charge is wat de leveranciers voor deze bestelling hebben gerekend, in dollars tegen de koers van de dag waarop ze is geplaatst. start_count komt van de leverancier die haar is gestart.

Saldo

smm.guide beheert geen geld van je. Het bedrag is de som van je saldi op de panels achter je routes, in dollars.

ParameterBeschrijving
keyJe API-sleutel
actionbalance

Antwoord

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

Annuleren

Doorgegeven aan de leverancier die de bestelling nu heeft, als diens dienst annuleren aanbiedt. Een bestelling die je annuleert, wordt nooit naar de volgende stap doorgestuurd.

ParameterBeschrijving
keyJe API-sleutel
actioncancel
ordersBestel-ID's gescheiden door een komma, maximaal 100

Antwoord

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

Refill

Doorgegeven aan de leverancier die de bestelling heeft geleverd. De refill draagt het nummer van de bestelling zelf.

ParameterBeschrijving
keyJe API-sleutel
actionrefill
orderBestel-ID. Of orders: meerdere, gescheiden door een komma

Antwoord, één bestelling

{ "refill": "23501" }

Antwoord, meerdere

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterBeschrijving
keyJe API-sleutel
actionrefill_status
refillRefill-ID. Of refills: meerdere, gescheiden door een komma

Antwoord

{ "status": "Completed" }

Wat een route met een bestelling doet

  • De stappen worden in jouw volgorde geprobeerd, of de goedkoopste werkende eerst. Je kiest welke in de route.
  • Een stap wordt overgeslagen als het panel niet antwoordt, het saldo of de dagelijkse limiet de bestelling niet dekt, het aantal buiten de grenzen valt, de prijs boven de limiet ligt die je hebt ingesteld, of de bestelling tegen die prijs de eigen dagelijkse limiet van de route zou overschrijden. Hij komt vanzelf terug.
  • Een stap valt uit als de dienst van de prijslijst verdwijnt, of als het panel onder dezelfde ID iets anders gaat verkopen. De andere stappen blijven werken en je krijgt bericht.
  • Een weigering stuurt de bestelling door. Als een panel antwoordt en weigert, is er niets afgeschreven, dus wordt de volgende stap geprobeerd.
  • Geen duidelijk antwoord stopt haar. Een time-out of een kapot antwoord zegt niet of de bestelling bestaat. Doorsturen zou haar twee keer kunnen laten leveren en afrekenen, dus de route stopt en je controleert die ene bestelling in je account.
  • Eén lopende bestelling per link. Zolang er een bestelling voor een link op een route loopt, wordt een tweede voor dezelfde link geweigerd, zoals leveranciers zelf ook doen.
  • Een annulering vóór levering kan ook worden doorgestuurd, als je dat hebt aangezet. Wat een gedeeltelijke bestelling niet heeft geleverd, gaat alleen door als je daarom hebt gevraagd.

Fouten

FoutWat het betekent
Invalid API keyDe sleutel is onjuist, vervangen of ingetrokken.
This key is limited to certain addresses…Het verzoek kwam van een adres dat niet op de lijst van de sleutel staat.
Incorrect requestOnbekend action.
Incorrect service IDGeen van je routes heeft deze ID. Een route die je hebt verwijderd, houdt haar nummer, en dat wordt nooit aan een andere gegeven.
Incorrect order IDGeen van je bestellingen heeft dit nummer.
Link is required, Quantity is requiredEen veld van add ontbreekt of is geen getal.
A route takes a link and a quantity onlyHet verzoek bevatte drip-feed, reacties of een ander extra veld.
This route is switched offZet het aan in je account.
This route already has an order for this link…Wacht tot de lopende bestelling klaar is.
No step of this route can take this order right now. …Elke stap werd overgeslagen voordat er iets werd verstuurd. De tekst noemt elk panel en de reden.
No step of this route accepted the order. …Elke stap die werd gevraagd, weigerde. Er is niets afgeschreven.
Too many requests…Boven de limiet hieronder. Wacht een minuut.

Voorbeelden

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

Een add wordt altijd binnen 30 seconden beantwoord. Een route kan meerdere leveranciers na elkaar vragen; elk krijgt wat er van die tijd over is, en een leverancier op wie niet kan worden gewacht, wordt helemaal niet gevraagd. Als de laatst gevraagde leverancier niet heeft geantwoord wanneer de tijd om is, krijg je een bestelnummer met de status Pending, en de route stopt daar tot het antwoord bekend is. De meeste bestellingen worden binnen een of twee seconden beantwoord.

Limieten en beveiliging

  • 300 verzoeken per minuut per sleutel, waarvan 120 bestellingen. Maximaal 100 bestel-ID's in één status aanroep.
  • De sleutel wordt één keer getoond en als vingerafdruk bewaard. Jij noch wij kunnen hem opnieuw lezen. Bij vervanging wordt de oude direct uitgeschakeld.
  • Toegestane adressen. Geef in je account het serveradres van je panel op, dan werkt de sleutel nergens anders.
  • Een route-ID is geen geheim en hoeft dat ook niet te zijn. Hij werkt alleen samen met de sleutel van het account dat eigenaar is van de route.
  • Je limieten blijven gelden. De dagelijkse limiet van elk panel, de eigen dagelijkse limiet van de route en haar grootste bestelling gelden voor bestellingen die via de API binnenkomen precies zoals voor bestellingen die je handmatig plaatst.
  • Geld loopt nooit via smm.guide. Elke bestelling wordt betaald uit je saldo op het panel dat haar aanneemt. Terugbetalingen en geschillen blijven tussen jou en dat panel.

Wil je juist de catalogus lezen?

Panels, Trust Scores en live prijzen hebben een eigen API, en een MCP-server voor assistenten.