Sākums / Izstrādātājiem / Orders API

Orders API

Pievienojiet smm.guide savam panelim kā piegādātāju. Katrs maršruts, ko izveidojat savā kontā, ir pakalpojums ar savu ID: jūsu panelis nosūta pasūtījumu uz šo ID, un maršruts to nodod pirmajam no jūsu piegādātājiem, kas to var pieņemt.

Trīs soļi

Formāts ir tas pats, ko SMM paneļi jau izmanto savā starpā, tāpēc nekas nav jāprogrammē.

1Izveidojiet maršrutuKonts, Orders desk, Maršruti. Izvēlieties, ko tas piegādā, un pievienojiet līdz pieciem šāda veida pakalpojumiem no pieslēgtajiem paneļiem.
2Izveidojiet atslēguOrders desk, Orders API. Atslēga tiek parādīta vienreiz. Varat to ierobežot līdz jūsu paneļa servera adresei.
3Pievienojiet piegādātāju savā panelīAPI URL https://smm.guide/api/v2 un atslēgu. Importējiet pakalpojumus: jūsu maršruti tiek ielādēti ar saviem ID, cenām un limitiem.

Pieprasījuma formāts

HTTP metodePOST
API URLhttps://smm.guide/api/v2
Ķermenisapplication/x-www-form-urlencoded, vai JSON ar Content-Type: application/json. A multipart/form-data ķermenis arī tiek nolasīts; tādu sūta PHP, kad cURL tiek nodots masīvs
AtbildeJSON, vienmēr ar HTTP 200, arī tad, ja ķermeni nevaram nolasīt vai pieprasījums ir pārāk liels. Kļūda ir {"error": "…"}
NaudaASV dolāri. Cenas ir par 1000

Pakalpojumu saraksts

Jūsu maršruti, kas pašlaik var pieņemt pasūtījumu. Maršruts, kas ir izslēgts vai kura visi soļi nedarbojas, sarakstā netiek iekļauts.

ParametrsApraksts
keyJūsu API atslēga
actionservices

Atbilde

[
  {
    "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 ir dārgākais no maršruta soļiem, kas var pieņemt pasūtījumu, ieskaitot pagaidām izlaistos (panelis, kas šodien nedarbojas, rīt var atkal darboties), tāpēc pasūtījums nekad nemaksā vairāk par cenu, ko importēja jūsu panelis. min un max ir plašākās robežas, ko kopā aptver strādājošie soļi; daudzums, kas iekļaujas tikai dažu soļu robežās, tiek nosūtīts uz vienu no tiem. refill un cancel ir true, ja tos piedāvā katrs šāds solis.

Maršruts, kas ir izslēgts vai kuram nav neviena strādājoša soļa, šajā sarakstā netiek iekļauts, līdz tas atkal darbojas. Panelis, kas automātiski sinhronizē savus pakalpojumus, uz to pašu laiku izslēgs šo pakalpojumu savā pusē, un tas ir tieši tas, kas vajadzīgs: tā pasūtījumi tiktu noraidīti.

Pievienot pasūtījumu

ParametrsApraksts
keyJūsu API atslēga
actionadd
serviceMaršruta ID, astoņi cipari
linkSaite uz lapu, publikāciju vai profilu
quantityNepieciešamais daudzums

Atbilde

{
  "order": 23501
}

Neviens to nepieņēma

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

Pasūtījuma numurs paliek nemainīgs visu pasūtījuma dzīves laiku neatkarīgi no tā, kurš piegādātājs to beigās izpilda. Maršruts pieņem saiti un daudzumu; pakāpeniska padeve, komentāri un citi papildu lauki tiek noraidīti.

Pasūtījuma statuss

ParametrsApraksts
keyJūsu API atslēga
actionstatus
orderPasūtījuma ID

Atbilde

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametrsApraksts
keyJūsu API atslēga
actionstatus
ordersPasūtījumu ID, atdalīti ar komatu, līdz 100

Atbilde

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatussNozīme
PendingPiegādātājs to pieņēmis, bet izpilde vēl nav sākta. Arī pasūtījums, par kuru piegādātājs nedeva skaidru atbildi: maršruts tajā apstājas, līdz to pārbaudāt savā kontā.
In progress, ProcessingPiegādātājs to izpilda, vai arī pasūtījums tiek nodots nākamajam solim.
CompletedPiegādāts pilnībā.
PartialPiegādāts daļēji; remains ir tas, kas netika piegādāts. Tiek skaitīts tas, ko piegādāja visi soļi: ja viens solis piegādāja daļu un atlikums tika atcelts nākamajā, pasūtījums ir Partial, nevis Canceled. Par atlikušās maksas atgriešanu lemj piegādātājs.
CanceledNekas netika piegādāts, un neviens cits solis pasūtījumu nepieņēma. charge rāda, kas, ja vispār, palika iekasēts.

charge ir summa, ko piegādātāji iekasēja par šo pasūtījumu, dolāros pēc tās dienas kursa, kad tas tika veikts. start_count tiek saņemts no piegādātāja, kas sāka to izpildīt.

Bilance

smm.guide netur jūsu naudu. Skaitlis ir jūsu bilanču summa paneļos aiz jūsu maršrutiem, dolāros.

ParametrsApraksts
keyJūsu API atslēga
actionbalance

Atbilde

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

Atcelt

Tiek nodots piegādātājam, pie kura pasūtījums ir pašlaik, ja tā pakalpojums piedāvā atcelšanu. Jūsu atcelts pasūtījums nekad netiek nodots nākamajam solim.

ParametrsApraksts
keyJūsu API atslēga
actioncancel
ordersPasūtījumu ID, atdalīti ar komatu, līdz 100

Atbilde

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

Papildināšana

Tiek nodota piegādātājam, kas izpildīja pasūtījumu. Papildināšanai ir paša pasūtījuma numurs.

ParametrsApraksts
keyJūsu API atslēga
actionrefill
orderPasūtījuma ID. Vai orders: vairāki, atdalīti ar komatu

Atbilde, viens pasūtījums

{ "refill": "23501" }

Atbilde, vairāki

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametrsApraksts
keyJūsu API atslēga
actionrefill_status
refillPapildināšanas ID. Vai refills: vairāki, atdalīti ar komatu

Atbilde

{ "status": "Completed" }

Ko maršruts dara ar pasūtījumu

  • Soļi tiek izmēģināti jūsu secībā vai sākot ar lētāko strādājošo. To izvēlaties maršrutā.
  • Solis tiek izlaists, ja tā panelis neatbild, tā bilance vai dienas limits nesedz pasūtījumu, daudzums ir ārpus tā pieņemamajām robežām, tā cena pārsniedz jūsu noteikto limitu vai ar tā cenu pasūtījums pārsniegtu paša maršruta dienas limitu. Tas atgriežas pats.
  • Solis izkrīt, ja tā pakalpojums pazūd no cenrāža vai panelis ar to pašu ID sāk pārdot kaut ko citu. Pārējie soļi turpina darboties, un jums tiek paziņots.
  • Atteikums nodod pasūtījumu tālāk. Ja panelis atbild un atsaka, nekas netika iekasēts, tāpēc tiek izmēģināts nākamais solis.
  • Neskaidra atbilde to aptur. Noildze vai bojāta atbilde nepasaka, vai pasūtījums pastāv. Nosūtot to tālāk, tas varētu tikt izpildīts un apmaksāts divreiz, tāpēc maršruts apstājas un jūs pārbaudāt šo vienu pasūtījumu savā kontā.
  • Viens aktīvs pasūtījums uz saiti. Kamēr maršrutā tiek izpildīts pasūtījums kādai saitei, otrs pasūtījums tai pašai saitei tiek noraidīts — tāpat kā to dara paši piegādātāji.
  • Arī atcelšana pirms piegādes var nodot pasūtījumu tālāk, ja to ieslēdzāt. Tas, ko daļēji izpildīts pasūtījums atstāja nepiegādātu, tiek nodots tālāk tikai tad, ja to pieprasījāt.

Kļūdas

KļūdaKo tā nozīmē
Invalid API keyAtslēga ir nepareiza, aizstāta vai atsaukta.
This key is limited to certain addresses…Pieprasījums nāca no adreses, kas nav atslēgas sarakstā.
Incorrect requestNezināms action.
Incorrect service IDNevienam jūsu maršrutam nav šāda ID. Dzēsts maršruts saglabā savu numuru, un tas nekad netiek piešķirts citam.
Incorrect order IDNevienam jūsu pasūtījumam nav šāda numura.
Link is required, Quantity is requiredDarbības add lauks trūkst vai nav skaitlis.
A route takes a link and a quantity onlyPieprasījumā bija pakāpeniska padeve, komentāri vai cits papildu lauks.
This route is switched offIeslēdziet to savā kontā.
This route already has an order for this link…Pagaidiet, līdz aktīvais pasūtījums ir pabeigts.
No step of this route can take this order right now. …Katrs solis tika izlaists, pirms kaut kas tika nosūtīts. Tekstā norādīts katrs panelis un tā iemesls.
No step of this route accepted the order. …Katrs uzrunātais solis atteica. Nekas netika iekasēts.
Too many requests…Pārsniegts tālāk norādītais limits. Pagaidiet minūti.

Piemēri

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

Uz add pieprasījumu vienmēr tiek atbildēts 30 sekunžu laikā. Maršruts var uzrunāt vairākus piegādātājus vienu pēc otra; katrs saņem atlikušo šī laika daļu, un piegādātājs, kuru nevarētu sagaidīt, netiek uzrunāts vispār. Ja pēdējais uzrunātais nav atbildējis līdz laika beigām, jūs saņemat pasūtījuma numuru ar statusu Pending, un maršruts tajā apstājas, līdz atbilde ir zināma. Lielākā daļa pasūtījumu saņem atbildi vienas vai divu sekunžu laikā.

Limiti un drošība

  • 300 pieprasījumi minūtē katrai atslēgai, no tiem 120 pasūtījumi. Līdz 100 pasūtījumu ID vienā status izsaukums.
  • Atslēga tiek parādīta vienreiz un glabāta kā nospiedums. Ne jūs, ne mēs to vairs nevaram nolasīt. Aizstājot to, vecā atslēga tiek uzreiz atspējota.
  • Atļautās adreses. Norādiet savā kontā sava paneļa servera adresi, un atslēga darbosies tikai no tās.
  • Maršruta ID nav noslēpums, un tam tādam nav jābūt. Tas darbojas tikai kopā ar tā konta atslēgu, kuram pieder maršruts.
  • Jūsu limiti joprojām ir spēkā. Katra paneļa dienas limits, paša maršruta dienas limits un tā lielākais pasūtījums attiecas uz pasūtījumiem, kas pienāk caur API, tieši tāpat kā uz tiem, ko veicat manuāli.
  • Nauda nekad neiet caur smm.guide. Katrs pasūtījums tiek apmaksāts no jūsu bilances tajā panelī, kas to pieņem. Atmaksas un strīdi paliek starp jums un šo paneli.

Vēlaties lasīt katalogu?

Paneļiem, Trust Score un aktuālajām cenām ir savs API un MCP serveris asistentiem.