Avaleht / Arendajatele / Orders API

Orders API

Lisage smm.guide oma paneelile teenusepakkujana. Iga marsruut, mille oma kontol loote, on oma ID-ga teenus: teie paneel saadab tellimuse sellele ID-le ja marsruut annab selle edasi esimesele teie teenusepakkujale, kes saab selle vastu võtta.

Kolm sammu

Vorming on sama, mida SMM-paneelid juba omavahel kasutavad, seega pole vaja midagi programmeerida.

1Looge marsruutKonto, Orders desk, Marsruudid. Valige, mida see täidab, ja lisage ühendatud paneelidest kuni viis seda liiki teenust.
2Looge võtiOrders desk, Orders API. Võtit näidatakse üks kord. Saate selle piirata oma paneeli serveri aadressiga.
3Lisage oma paneelis teenusepakkujaAPI URL https://smm.guide/api/v2 ja võti. Importige teenused: teie marsruudid saabuvad koos ID-de, hindade ja limiitidega.

Päringu vorming

HTTP-meetodPOST
API URLhttps://smm.guide/api/v2
Kehaapplication/x-www-form-urlencoded, või JSON päisega Content-Type: application/json. A multipart/form-data keha loetakse samuti; seda saadab PHP, kui cURL-ile antakse massiiv
VastusJSON, alati HTTP 200-ga, ka siis, kui keha ei saa lugeda või päring on liiga suur. Viga on kujul {"error": "…"}
RahaUSA dollarid. Hinnad on 1000 tk kohta

Teenuste loend

Teie marsruudid, mis saavad praegu tellimust vastu võtta. Välja lülitatud marsruuti või marsruuti, mille kõik sammud on väljas, loendis ei ole.

ParameeterKirjeldus
keyTeie API-võti
actionservices

Vastus

[
  {
    "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 on marsruudi sammudest kalleim, mis võib tellimuse vastu võtta, kaasa arvatud ajutiselt vahele jäetud sammud (täna maas olev paneel on homme tagasi), nii et tellimus ei maksa kunagi rohkem kui teie paneeli imporditud hind. min ja max on laiemad piirid, mida töötavad sammud kokku katavad; kogus, mis sobib ainult mõnele neist, läheb ühele neist. refill ja cancel on true, kui iga selline samm neid pakub.

Välja lülitatud marsruut või marsruut, millel pole ühtegi töötavat sammu, jäetakse sellest loendist välja, kuni see on tagasi. Paneel, mis sünkroonib oma teenuseid automaatselt, lülitab selle teenuse oma poolel samaks ajaks välja – ja just seda te soovitegi: selle tellimused lükataks tagasi.

Lisa tellimus

ParameeterKirjeldus
keyTeie API-võti
actionadd
serviceMarsruudi ID, kaheksa numbrit
linkLink lehele, postitusele või profiilile
quantityVajalik kogus

Vastus

{
  "order": 23501
}

Keegi ei võtnud seda vastu

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

Tellimuse number jääb samaks kogu tellimuse eluea jooksul, olenemata sellest, milline teenusepakkuja selle lõpuks täidab. Marsruut võtab vastu lingi ja koguse; järkjärguline tarne, kommentaarid ja muud lisaväljad lükatakse tagasi.

Tellimuse olek

ParameeterKirjeldus
keyTeie API-võti
actionstatus
orderTellimuse ID

Vastus

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameeterKirjeldus
keyTeie API-võti
actionstatus
ordersTellimuste ID-d komaga eraldatult, kuni 100

Vastus

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
OlekTähendus
PendingTeenusepakkuja on selle vastu võtnud, kuid pole veel alustanud. Samuti tellimus, mille kohta teenusepakkuja selget vastust ei andnud: marsruut peatub seal, kuni olete selle oma kontol üle kontrollinud.
In progress, ProcessingTeenusepakkuja täidab seda või tellimus on teel järgmisele sammule.
CompletedTäidetud täielikult.
PartialOsaliselt täidetud; remains näitab täitmata osa. See arvestab kõigi sammude täidetud kogust: kui üks samm täitis osa ja ülejäänu tühistati järgmisel, on tellimus Partial, mitte Canceled. Ülejäänud tasu tagastamise üle otsustab teenusepakkuja.
CanceledMidagi ei täidetud ja ükski teine samm tellimust vastu ei võtnud. charge näitab, kui palju tasust (kui üldse) jäi võetuks.

charge on summa, mille teenusepakkujad selle tellimuse eest võtsid, dollarites esitamise päeva kursiga. start_count tuleb teenusepakkujalt, kes selle alustas.

Saldo

smm.guide ei hoia teie raha. See arv on teie saldode summa paneelides, mis on teie marsruutide taga, dollarites.

ParameeterKirjeldus
keyTeie API-võti
actionbalance

Vastus

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

Tühista

Edastatakse teenusepakkujale, kelle käes tellimus praegu on, kui selle teenus tühistamist pakub. Teie tühistatud tellimust ei saadeta kunagi järgmisele sammule.

ParameeterKirjeldus
keyTeie API-võti
actioncancel
ordersTellimuste ID-d komaga eraldatult, kuni 100

Vastus

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

Järeltäitmine

Edastatakse teenusepakkujale, kes tellimuse täitis. Järeltäitmine kannab tellimuse enda numbrit.

ParameeterKirjeldus
keyTeie API-võti
actionrefill
orderTellimuse ID. Või orders: mitu, komaga eraldatud

Vastus, üks tellimus

{ "refill": "23501" }

Vastus, mitu

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameeterKirjeldus
keyTeie API-võti
actionrefill_status
refillJäreltäitmise ID. Või refills: mitu, komaga eraldatud

Vastus

{ "status": "Completed" }

Mida marsruut tellimusega teeb

  • Samme proovitakse teie määratud järjekorras või odavaim töötav samm esimesena. Valiku teete marsruudis.
  • Samm jäetakse vahele, kui selle paneel ei vasta, selle saldo või päevalimiit ei kata tellimust, kogus jääb väljapoole lubatut, selle hind ületab teie seatud piiri või selle hinnaga ületaks tellimus marsruudi enda päevalimiidi. See naaseb ise.
  • Samm langeb välja, kui selle teenus kaob hinnakirjast või paneel hakkab sama ID all müüma midagi muud. Teised sammud töötavad edasi ja teid teavitatakse.
  • Keeldumine viib tellimuse edasi. Kui paneel vastab ja keeldub, pole raha võetud, seega proovitakse järgmist sammu.
  • Ebaselge vastus peatab selle. Aegumine või katkine vastus ei ütle, kas tellimus on olemas. Edasisaatmine võiks selle kaks korda täita ja kaks korda tasu võtta, seega marsruut peatub ja te kontrollite seda tellimust oma kontol.
  • Üks käimasolev tellimus lingi kohta. Kui lingi tellimus on marsruudil käimas, lükatakse sama lingi teine tellimus tagasi, nagu teevad ka teenusepakkujad ise.
  • Ka enne täitmist tühistatud tellimus võib edasi liikuda, kui olete selle sisse lülitanud. Osalise tellimuse täitmata osa liigub edasi ainult siis, kui olete seda palunud.

Vead

VigaMida see tähendab
Invalid API keyVõti on vale, asendatud või tühistatud.
This key is limited to certain addresses…Päring tuli aadressilt, mis ei ole võtme lubatud aadresside loendis.
Incorrect requestTeadmata action.
Incorrect service IDTeil pole selle ID-ga marsruuti. Kustutatud marsruut säilitab oma numbri ja seda ei anta kunagi kellelegi teisele.
Incorrect order IDTeil pole selle numbriga tellimust.
Link is required, Quantity is requiredPäringu add mõni väli puudub või ei ole number.
A route takes a link and a quantity onlyPäringus oli järkjärguline tarne, kommentaarid või muu lisaväli.
This route is switched offLülitage see oma kontol sisse.
This route already has an order for this link…Oodake, kuni käimasolev tellimus on lõppenud.
No step of this route can take this order right now. …Kõik sammud jäeti vahele enne, kui midagi saadeti. Tekstis on nimetatud iga paneel ja selle põhjus.
No step of this route accepted the order. …Kõik küsitud sammud keeldusid. Raha ei võetud.
Too many requests…Allpool toodud limiit on ületatud. Oodake minut.

Näited

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

Päringule add vastatakse alati 30 sekundi jooksul. Marsruut võib küsida mitmelt teenusepakkujalt üksteise järel; igaüks saab sellest ajast järelejäänud osa ja teenusepakkujalt, keda ei jõuaks ära oodata, üldse ei küsita. Kui viimane küsitu pole aja lõppedes vastanud, saate tellimuse numbri olekuga Pending ja marsruut peatub seal, kuni vastus on teada. Enamikule tellimustele vastatakse ühe-kahe sekundiga.

Limiidid ja turvalisus

  • 300 päringut minutis võtme kohta, neist 120 tellimust. Kuni 100 tellimuse ID-d ühes status päring.
  • Võtit näidatakse üks kord ja see säilitatakse sõrmejäljena. Ei teie ega meie saa seda uuesti lugeda. Asendamine lülitab vana võtme kohe välja.
  • Lubatud aadressid. Lisage oma kontol oma paneeli serveri aadress ja võti ei tööta kusagilt mujalt.
  • Marsruudi ID ei ole saladus ega peagi olema. See töötab ainult koos marsruudi omaniku konto võtmega.
  • Teie limiidid kehtivad edasi. Iga paneeli päevalimiit, marsruudi enda päevalimiit ja suurim tellimus kehtivad API kaudu saabuvatele tellimustele täpselt samamoodi nagu käsitsi esitatutele.
  • Raha ei liigu kunagi läbi smm.guide'i. Iga tellimuse eest makstakse teie saldolt paneelis, mis selle vastu võtab. Tagasimaksed ja vaidlused jäävad teie ja selle paneeli vahele.

Soovite hoopis kataloogi lugeda?

Paneelidel, Trust Score'idel ja reaalajas hindadel on oma API ning MCP-server assistentidele.