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ē.
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 metode | POST |
| API URL | https://smm.guide/api/v2 |
| Ķermenis | application/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 |
| Atbilde | JSON, vienmēr ar HTTP 200, arī tad, ja ķermeni nevaram nolasīt vai pieprasījums ir pārāk liels. Kļūda ir {"error": "…"} |
| Nauda | ASV 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.
| Parametrs | Apraksts |
|---|---|
key | Jūsu API atslēga |
action | services |
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
| Parametrs | Apraksts |
|---|---|
key | Jūsu API atslēga |
action | add |
service | Maršruta ID, astoņi cipari |
link | Saite uz lapu, publikāciju vai profilu |
quantity | Nepiecieš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
| Parametrs | Apraksts |
|---|---|
key | Jūsu API atslēga |
action | status |
order | Pasūtījuma ID |
Atbilde
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametrs | Apraksts |
|---|---|
key | Jūsu API atslēga |
action | status |
orders | Pasū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" }
}| Statuss | Nozīme |
|---|---|
Pending | Piegā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, Processing | Piegādātājs to izpilda, vai arī pasūtījums tiek nodots nākamajam solim. |
Completed | Piegādāts pilnībā. |
Partial | Piegā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. |
Canceled | Nekas 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.
| Parametrs | Apraksts |
|---|---|
key | Jūsu API atslēga |
action | balance |
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.
| Parametrs | Apraksts |
|---|---|
key | Jūsu API atslēga |
action | cancel |
orders | Pasū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.
| Parametrs | Apraksts |
|---|---|
key | Jūsu API atslēga |
action | refill |
order | Pasū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": "…" } }
]| Parametrs | Apraksts |
|---|---|
key | Jūsu API atslēga |
action | refill_status |
refill | Papildināš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ļūda | Ko tā nozīmē |
|---|---|
Invalid API key | Atslē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 request | Nezināms action. |
Incorrect service ID | Nevienam jūsu maršrutam nav šāda ID. Dzēsts maršruts saglabā savu numuru, un tas nekad netiek piešķirts citam. |
Incorrect order ID | Nevienam jūsu pasūtījumam nav šāda numura. |
Link is required, Quantity is required | Darbības add lauks trūkst vai nav skaitlis. |
A route takes a link and a quantity only | Pieprasījumā bija pakāpeniska padeve, komentāri vai cits papildu lauks. |
This route is switched off | Ieslē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ā
statusizsaukums. - 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.