მთავარი / დეველოპერებისთვის / Orders API
Orders API
დაამატეთ smm.guide თქვენს პანელში მომწოდებლად. ყოველი მარშრუტი, რომელსაც ანგარიშში ქმნით, არის სერვისი საკუთარი ID-ით: თქვენი პანელი შეკვეთას ამ ID-ზე აგზავნის, მარშრუტი კი მას თქვენი მომწოდებლებიდან პირველს გადასცემს, ვისაც მისი მიღება შეუძლია.
სამი ნაბიჯი
ფორმატი იგივეა, რასაც SMM პანელები ერთმანეთს შორის უკვე იყენებენ, ამიტომ არაფრის დაპროგრამება არ გჭირდებათ.
https://smm.guide/api/v2 და გასაღები. დააიმპორტეთ სერვისები: თქვენი მარშრუტები შემოვა თავისი ID-ებით, ფასებითა და ლიმიტებით.მოთხოვნის ფორმატი
| HTTP მეთოდი | POST |
| API URL | https://smm.guide/api/v2 |
| მოთხოვნის სხეული | application/x-www-form-urlencoded, ან JSON ჰედერით Content-Type: application/json. A multipart/form-data სხეულიც იკითხება — ასეთს აგზავნის PHP, როცა cURL-ს მასივი გადაეცემა |
| პასუხი | JSON, ყოველთვის HTTP 200-ით, მაშინაც, როცა სხეულის წაკითხვა ვერ ხერხდება ან მოთხოვნა ზედმეტად დიდია. შეცდომა ასე გამოიყურება: {"error": "…"} |
| თანხა | აშშ დოლარი. ფასები მითითებულია 1 000 ერთეულზე |
სერვისების სია
თქვენი მარშრუტები, რომლებსაც ახლა შეუძლიათ შეკვეთის მიღება. გამორთული მარშრუტი ან მარშრუტი, რომლის ყველა ნაბიჯი გათიშულია, სიაში არ ჩანს.
| პარამეტრი | აღწერა |
|---|---|
key | თქვენი API გასაღები |
action | services |
პასუხი
[
{
"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 არის მარშრუტის იმ ნაბიჯებიდან ყველაზე ძვირი, რომლებსაც შეკვეთის მიღება შეუძლიათ, დროებით გამოტოვებულების ჩათვლით (დღეს გათიშული პანელი ხვალ დაბრუნდება), ამიტომ შეკვეთა არასდროს ღირს იმაზე მეტი, ვიდრე თქვენმა პანელმა დააიმპორტა. min და max წარმოადგენს მოქმედი ნაბიჯების ერთობლივ ყველაზე ფართო დიაპაზონს; რაოდენობა, რომელიც მხოლოდ ზოგიერთ მათგანს შეესაბამება, ერთ-ერთ მათგანზე გადადის. refill და cancel არის true, თუ ყველა ასეთი ნაბიჯი მათ მხარს უჭერს.
გამორთული მარშრუტი ან მარშრუტი, რომელსაც მოქმედი ნაბიჯი არ აქვს, ამ სიიდან ამოღებულია, სანამ არ აღდგება. პანელი, რომელიც სერვისებს ავტომატურად ასინქრონებს, იმავე დროით თავის მხარეს გამორთავს ამ სერვისს — და სწორედ ეს გჭირდებათ: მისი შეკვეთები ისედაც უარყოფილი იქნებოდა.
შეკვეთის დამატება
| პარამეტრი | აღწერა |
|---|---|
key | თქვენი API გასაღები |
action | add |
service | მარშრუტის ID, რვა ციფრი |
link | ბმული გვერდზე, პოსტზე ან პროფილზე |
quantity | საჭირო რაოდენობა |
პასუხი
{
"order": 23501
}
ვერავინ მიიღო
{
"error": "No step of this route accepted the order. …"
}შეკვეთის ნომერი უცვლელი რჩება შეკვეთის მთელი სიცოცხლის განმავლობაში, მიუხედავად იმისა, რომელი მომწოდებელი შეასრულებს მას. მარშრუტი იღებს ბმულსა და რაოდენობას; თანდათანობითი მიწოდება, კომენტარები და სხვა დამატებითი ველები უარყოფილია.
შეკვეთის სტატუსი
| პარამეტრი | აღწერა |
|---|---|
key | თქვენი API გასაღები |
action | status |
order | შეკვეთის ID |
პასუხი
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| პარამეტრი | აღწერა |
|---|---|
key | თქვენი API გასაღები |
action | status |
orders | შეკვეთების ID-ები მძიმით გამოყოფილი, მაქსიმუმ 100 |
პასუხი
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| სტატუსი | მნიშვნელობა |
|---|---|
Pending | მომწოდებელმა მიიღო და ჯერ არ დაუწყია. ასევე შეკვეთა, რომელზეც მომწოდებელმა მკაფიო პასუხი არ გასცა: მარშრუტი იქ ჩერდება, სანამ მას თქვენს ანგარიშში არ შეამოწმებთ. |
In progress, Processing | მომწოდებელი ასრულებს მას ან შეკვეთა შემდეგ ნაბიჯზე გადადის. |
Completed | სრულად შესრულებულია. |
Partial | ნაწილობრივ შესრულებულია; remains არის ის, რაც არ შესრულებულა. ის ითვალისწინებს ყველა ნაბიჯის შესრულებულ მოცულობას: როცა ერთმა ნაბიჯმა ნაწილი შეასრულა, დანარჩენი კი შემდეგზე გაუქმდა, შეკვეთა არის Partial და არა Canceled. დარჩენილი თანხის დაბრუნებას მომწოდებელი წყვეტს. |
Canceled | არაფერი შესრულებულა და შეკვეთა სხვა ნაბიჯმაც არ მიიღო. charge აჩვენებს, რა თანხა დარჩა ჩამოჭრილი, ასეთის არსებობის შემთხვევაში. |
charge არის თანხა, რომელიც მომწოდებლებმა ამ შეკვეთისთვის ჩამოჭრეს, დოლარში, გაფორმების დღის კურსით. start_count მოდის მომწოდებლისგან, რომელმაც ის დაიწყო.
ბალანსი
smm.guide თქვენს თანხას არ ინახავს. ეს მონაცემი არის თქვენი ბალანსების ჯამი იმ პანელებზე, რომლებზეც თქვენი მარშრუტებია აგებული, დოლარში.
| პარამეტრი | აღწერა |
|---|---|
key | თქვენი API გასაღები |
action | balance |
პასუხი
{
"balance": "126.1375",
"currency": "USD"
}გაუქმება
გადაეცემა მომწოდებელს, რომელთანაც შეკვეთა ახლაა, თუ მისი სერვისი გაუქმებას მხარს უჭერს. თქვენ მიერ გაუქმებული შეკვეთა არასდროს გადადის შემდეგ ნაბიჯზე.
| პარამეტრი | აღწერა |
|---|---|
key | თქვენი API გასაღები |
action | cancel |
orders | შეკვეთების ID-ები მძიმით გამოყოფილი, მაქსიმუმ 100 |
პასუხი
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]აღდგენა
გადაეცემა მომწოდებელს, რომელმაც შეკვეთა შეასრულა. აღდგენას შეკვეთის საკუთარი ნომერი აქვს.
| პარამეტრი | აღწერა |
|---|---|
key | თქვენი API გასაღები |
action | refill |
order | შეკვეთის ID. ან orders: რამდენიმე, მძიმით გამოყოფილი |
პასუხი, ერთი შეკვეთა
{ "refill": "23501" }
პასუხი, რამდენიმე
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| პარამეტრი | აღწერა |
|---|---|
key | თქვენი API გასაღები |
action | refill_status |
refill | აღდგენის ID. ან refills: რამდენიმე, მძიმით გამოყოფილი |
პასუხი
{ "status": "Completed" }რას აკეთებს მარშრუტი შეკვეთით
- ნაბიჯები იცდება თქვენი რიგით ან ჯერ ყველაზე იაფი მოქმედი. რომელი — ამას მარშრუტში ირჩევთ.
- ნაბიჯი გამოიტოვება, როცა მისი პანელი არ პასუხობს, მისი ბალანსი ან დღიური ლიმიტი შეკვეთას არ ფარავს, რაოდენობა მის დასაშვებ ფარგლებს სცდება, მისი ფასი თქვენ მიერ დაწესებულ ლიმიტზე მაღალია ან მისი ფასით შეკვეთა მარშრუტის საკუთარ დღიურ ლიმიტს გადააჭარბებდა. ის თავად ბრუნდება.
- ნაბიჯი ითიშება, როცა მისი სერვისი ფასების სიიდან ქრება ან პანელი იმავე ID-ით სხვა რამის გაყიდვას იწყებს. დანარჩენი ნაბიჯები მუშაობას განაგრძობენ და თქვენ შეგატყობინებთ.
- უარი შეკვეთას შემდეგზე გადაიტანს. როცა პანელი პასუხობს და უარს ამბობს, არაფერი ჩამოიჭრება, ამიტომ შემდეგი ნაბიჯი იცდება.
- მკაფიო პასუხის არარსებობა მას აჩერებს. დროის ამოწურვა ან დაზიანებული პასუხი არ გვეუბნება, არსებობს თუ არა შეკვეთა. მისმა გადაგზავნამ შეიძლება ის ორჯერ შეასრულოს და ორჯერ ჩამოჭრას, ამიტომ მარშრუტი ჩერდება და თქვენ ამ ერთ შეკვეთას თქვენს ანგარიშში ამოწმებთ.
- ერთ ბმულზე ერთი აქტიური შეკვეთა. სანამ მარშრუტზე ბმულის შეკვეთა სრულდება, იმავე ბმულის მეორე შეკვეთა უარყოფილია, ისევე როგორც თავად მომწოდებლებთან.
- შესრულებამდე გაუქმებაც შეიძლება გადავიდეს შემდეგზე, თუ ეს ჩართეთ. ნაწილობრივი შეკვეთის შეუსრულებელი ნაწილი შემდეგზე მხოლოდ მაშინ გადადის, თუ ეს მოითხოვეთ.
შეცდომები
| შეცდომა | რას ნიშნავს |
|---|---|
Invalid API key | გასაღები არასწორია, შეცვლილია ან გაუქმებულია. |
This key is limited to certain addresses… | მოთხოვნა მოვიდა მისამართიდან, რომელიც გასაღების სიაში არ არის. |
Incorrect request | უცნობი action. |
Incorrect service ID | თქვენს არცერთ მარშრუტს არ აქვს ეს ID. წაშლილი მარშრუტი თავის ნომერს ინარჩუნებს და ის სხვას არასდროს მიენიჭება. |
Incorrect order ID | თქვენს არცერთ შეკვეთას არ აქვს ეს ნომერი. |
Link is required, Quantity is required | ერთ-ერთი ველი add აკლია ან რიცხვი არ არის. |
A route takes a link and a quantity only | მოთხოვნა შეიცავდა თანდათანობით მიწოდებას, კომენტარებს ან სხვა დამატებით ველს. |
This route is switched off | ჩართეთ ის თქვენს ანგარიშში. |
This route already has an order for this link… | დაელოდეთ მიმდინარე შეკვეთის დასრულებას. |
No step of this route can take this order right now. … | ყველა ნაბიჯი გამოტოვებულ იქნა, სანამ რამე გაიგზავნებოდა. ტექსტში დასახელებულია თითოეული პანელი და მისი მიზეზი. |
No step of this route accepted the order. … | ყველა ნაბიჯმა, რომელსაც მივმართეთ, უარი თქვა. არაფერი ჩამოჭრილა. |
Too many requests… | ქვემოთ მითითებული ლიმიტი გადაჭარბებულია. დაელოდეთ ერთ წუთს. |
მაგალითები
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]);
მოთხოვნა add ყოველთვის იღებს პასუხს 30 წამის განმავლობაში. მარშრუტმა შეიძლება რამდენიმე მომწოდებელს მიმართოს ერთმანეთის მიყოლებით; თითოეული იღებს ამ დროის დარჩენილ ნაწილს, ხოლო მომწოდებელს, რომლის ლოდინიც შეუძლებელია, საერთოდ არ მივმართავთ. თუ ბოლო მომწოდებელმა დროის ამოწურვამდე არ უპასუხა, მიიღებთ შეკვეთის ნომერს სტატუსით Pending და მარშრუტი იქ ჩერდება, სანამ პასუხი არ გახდება ცნობილი. შეკვეთების უმეტესობა პასუხს ერთ-ორ წამში იღებს.
ლიმიტები და უსაფრთხოება
- წუთში 300 მოთხოვნა თითო გასაღებზე, მათგან 120 — შეკვეთები. 100-მდე შეკვეთის ID ერთად
statusმოთხოვნა. - გასაღები მხოლოდ ერთხელ ჩანს და ანაბეჭდის სახით ინახება. მას ხელახლა ვერც თქვენ წაიკითხავთ და ვერც ჩვენ. ჩანაცვლებისას ძველი მაშინვე გაითიშება.
- დაშვებული მისამართები. მიუთითეთ თქვენი პანელის სერვერის მისამართი ანგარიშში და გასაღები სხვა არსაიდან არ იმუშავებს.
- მარშრუტის ID საიდუმლო არ არის და არც უნდა იყოს. ის მუშაობს მხოლოდ იმ ანგარიშის გასაღებთან ერთად, რომელსაც მარშრუტი ეკუთვნის.
- თქვენი ლიმიტები კვლავ მოქმედებს. თითოეული პანელის დღიური ლიმიტი, მარშრუტის საკუთარი დღიური ლიმიტი და მისი უდიდესი შეკვეთა API-ით შემოსულ შეკვეთებზე ზუსტად ისე ვრცელდება, როგორც ხელით გაფორმებულზე.
- თანხა არასდროს გადის smm.guide-ზე. ყოველი შეკვეთა იხდება თქვენი ბალანსიდან იმ პანელზე, რომელიც მას იღებს. დაბრუნებები და დავები თქვენსა და ამ პანელს შორის რჩება.
გსურთ კატალოგის წაკითხვა?
პანელებს, Trust Score-ებს და აქტუალურ ფასებს საკუთარი API აქვს, ასისტენტებისთვის კი — MCP სერვერი.