Αρχική / Για προγραμματιστές / Orders API
Orders API
Προσθέστε το smm.guide στο πάνελ σας ως πάροχο. Κάθε διαδρομή που δημιουργείτε στον λογαριασμό σας είναι μια υπηρεσία με δικό της ID: το πάνελ σας στέλνει μια παραγγελία σε αυτό το ID και η διαδρομή τη μεταβιβάζει στον πρώτο από τους παρόχους σας που μπορεί να την αναλάβει.
Τρία βήματα
Η μορφή είναι αυτή που ήδη χρησιμοποιούν τα πάνελ SMM μεταξύ τους, οπότε δεν χρειάζεται προγραμματισμός.
https://smm.guide/api/v2 και το κλειδί. Εισαγάγετε τις υπηρεσίες: οι διαδρομές σας εμφανίζονται με τα ID, τις τιμές και τα όριά τους.Μορφή αιτήματος
| Μέθοδος HTTP | POST |
| URL του API | 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 για βοηθούς AI.