Orders API

დაამატეთ smm.guide თქვენს პანელში მომწოდებლად. ყოველი მარშრუტი, რომელსაც ანგარიშში ქმნით, არის სერვისი საკუთარი ID-ით: თქვენი პანელი შეკვეთას ამ ID-ზე აგზავნის, მარშრუტი კი მას თქვენი მომწოდებლებიდან პირველს გადასცემს, ვისაც მისი მიღება შეუძლია.

სამი ნაბიჯი

ფორმატი იგივეა, რასაც SMM პანელები ერთმანეთს შორის უკვე იყენებენ, ამიტომ არაფრის დაპროგრამება არ გჭირდებათ.

1შექმენით მარშრუტიანგარიში, Orders desk, მარშრუტები. აირჩიეთ, რას ასრულებს ის, და დაამატეთ ამ ტიპის მაქსიმუმ ხუთი სერვისი თქვენი დაკავშირებული პანელებიდან.
2შექმენით გასაღებიOrders desk, Orders API. გასაღები მხოლოდ ერთხელ ჩანს. შეგიძლიათ ის თქვენი პანელის სერვერის მისამართით შეზღუდოთ.
3დაამატეთ მომწოდებელი თქვენს პანელშიAPI URL https://smm.guide/api/v2 და გასაღები. დააიმპორტეთ სერვისები: თქვენი მარშრუტები შემოვა თავისი ID-ებით, ფასებითა და ლიმიტებით.

მოთხოვნის ფორმატი

HTTP მეთოდიPOST
API URLhttps://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 გასაღები
actionservices

პასუხი

[
  {
    "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 გასაღები
actionadd
serviceმარშრუტის ID, რვა ციფრი
linkბმული გვერდზე, პოსტზე ან პროფილზე
quantityსაჭირო რაოდენობა

პასუხი

{
  "order": 23501
}

ვერავინ მიიღო

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

შეკვეთის ნომერი უცვლელი რჩება შეკვეთის მთელი სიცოცხლის განმავლობაში, მიუხედავად იმისა, რომელი მომწოდებელი შეასრულებს მას. მარშრუტი იღებს ბმულსა და რაოდენობას; თანდათანობითი მიწოდება, კომენტარები და სხვა დამატებითი ველები უარყოფილია.

შეკვეთის სტატუსი

პარამეტრიაღწერა
keyთქვენი API გასაღები
actionstatus
orderშეკვეთის ID

პასუხი

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
პარამეტრიაღწერა
keyთქვენი API გასაღები
actionstatus
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 გასაღები
actionbalance

პასუხი

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

გაუქმება

გადაეცემა მომწოდებელს, რომელთანაც შეკვეთა ახლაა, თუ მისი სერვისი გაუქმებას მხარს უჭერს. თქვენ მიერ გაუქმებული შეკვეთა არასდროს გადადის შემდეგ ნაბიჯზე.

პარამეტრიაღწერა
keyთქვენი API გასაღები
actioncancel
ordersშეკვეთების ID-ები მძიმით გამოყოფილი, მაქსიმუმ 100

პასუხი

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

აღდგენა

გადაეცემა მომწოდებელს, რომელმაც შეკვეთა შეასრულა. აღდგენას შეკვეთის საკუთარი ნომერი აქვს.

პარამეტრიაღწერა
keyთქვენი API გასაღები
actionrefill
orderშეკვეთის ID. ან orders: რამდენიმე, მძიმით გამოყოფილი

პასუხი, ერთი შეკვეთა

{ "refill": "23501" }

პასუხი, რამდენიმე

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
პარამეტრიაღწერა
keyთქვენი API გასაღები
actionrefill_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 სერვერი.