Το API του Wizard4SocialMedia σάς επιτρέπει να αλληλεπιδράτε με τον ιστότοπό μας στέλνοντας απλώς ένα αίτημα στον διακομιστή μας. Αυτή η υπηρεσία προσφέρεται δωρεάν.
Μπορείτε να αυτοματοποιήσετε την τοποθέτηση παραγγελιών, να παρακολουθείτε την κατάσταση παράδοσης, να παρακολουθείτε το τρέχον υπόλοιπό σας και να έχετε προγραμματιστική πρόσβαση σε όλες τις πληροφορίες υπηρεσιών μας. Ιδανικό για μεταπωλητές που διαχειρίζονται τα δικά τους panel, πρακτορεία που διαχειρίζονται πολλούς πελάτες, ή προγραμματιστές που δημιουργούν προσαρμοσμένες λύσεις.
| Μέθοδος HTTP | POST |
| URL API | https://wizard4socialmedia.com/api/v2 |
| Κλειδί API | Αποκτήστε ένα κλειδί API στη σελίδα Λογαριασμός |
| Μορφή Απόκρισης | JSON |
| Παράδειγμα Κώδικα PHP | https://wizard4socialmedia.com/example.txt |
Χρησιμοποιήστε αυτή τη μέθοδο για να κάνετε νέα παραγγελία για οποιαδήποτε ενεργή υπηρεσία.
| Παράμετροι | Περιγραφές |
|---|---|
| api_token | Το API token σας |
| action | Όνομα Μεθόδου |
| service | ID υπηρεσίας |
| link | Σύνδεσμος σελίδας |
| quantity | Απαιτούμενη ποσότητα |
Απάντηση Επιτυχίας:
{
"order":"23501"
}
Όταν υποβάλλετε παραγγελία συνδρομής ΧΩΡΙΣ την προαιρετική παράμετρο callback, δημιουργούμε κάθε υποπαραγγελία από την πλευρά μας μόλις φτάσει η ώρα της και το πάνελ σας δεν ειδοποιείται. Εσείς είστε υπεύθυνοι να χρεώσετε τον δικό σας πελάτη γι' αυτήν.
Όταν υποβάλλετε παραγγελία συνδρομής ΜΕ την προαιρετική παράμετρο callback, ζητάμε την έγκριση του πάνελ σας πριν δημιουργήσουμε κάθε υποπαραγγελία. Η υποπαραγγελία δημιουργείται μόνο αν το πάνελ σας απαντήσει ναι.
Έτσι μπορείτε να χρεώνετε τον δικό σας πελάτη τη στιγμή που δημιουργείται κάθε υποπαραγγελία. Χωρίς αυτό, μια συνδρομή μπορεί να δημιουργεί υποπαραγγελίες από την πλευρά μας ενώ ο πελάτης σας δεν έχει υπόλοιπο στο πάνελ σας, και εσείς θα πληρώνατε παραγγελίες που δεν μπορείτε να χρεώσετε. Με το callback, το πάνελ σας αποφασίζει πρώτο: αν ο πελάτης σας δεν μπορεί να πληρώσει, η υποπαραγγελία δεν δημιουργείται ποτέ.
ΤΟ ΑΙΤΗΜΑ
Στέλνουμε ένα αίτημα POST στη διεύθυνση callback σας με σώμα JSON. Η διεύθυνση πρέπει να χρησιμοποιεί https σε δημόσιο host, με την προεπιλεγμένη θύρα και χωρίς διαπιστευτήρια. Δεν ακολουθούμε ανακατευθύνσεις.
| Παράμετροι | Περιγραφές |
|---|---|
| parent | Το αναγνωριστικό της παραγγελίας συνδρομής από την πλευρά μας, όπως επιστράφηκε όταν υποβάλατε την παραγγελία |
| order | Το αναγνωριστικό της υποπαραγγελίας από την πλευρά μας (Χρησιμοποιήστε το για να αναγνωρίζετε επαναλαμβανόμενες ερωτήσεις) |
| link | Ο σύνδεσμος της ανάρτησης για την οποία προορίζεται η υποπαραγγελία |
| quantity | Η ποσότητα της υποπαραγγελίας |
| is_old | 1 αν η υποπαραγγελία αφορά παλιά ανάρτηση, 0 αν αφορά νέα ανάρτηση |
| timestamp | Ώρα Unix κατά την οποία έγινε το αίτημα |
| signature | Υπογραφή HMAC-SHA256 του αιτήματος, σε δεκαεξαδική μορφή |
Παράδειγμα σώματος αιτήματος:
{
"parent": "919",
"order": "930",
"link": "https://x.com/user/status/123456789",
"quantity": 120,
"is_old": 0,
"timestamp": 1767225600,
"signature": "<64 hex characters>"
}
Επαλήθευση της υπογραφής
Η υπογραφή είναι HMAC-SHA256, που δημιουργείται με το κλειδί API σας στο πάνελ μας. Υπολογίζεται πάνω στις παρακάτω τιμές, ενωμένες με αλλαγές γραμμής, με αυτή τη σειρά: parent, order, quantity, is_old, timestamp, link. Χρησιμοποιήστε τις τιμές ακριβώς όπως τις λάβατε.
Συμβολοσειρά που υπογράφεται (για το παραπάνω παράδειγμα αιτήματος):
919 930 120 0 1767225600 https://x.com/user/status/123456789
Παράδειγμα επαλήθευσης σε PHP:
$key = 'YOUR_API_KEY';
$d = json_decode(file_get_contents('php://input'), true);
$string = implode("\n", [$d['parent'], $d['order'], $d['quantity'], $d['is_old'], $d['timestamp'], $d['link']]);
$valid = hash_equals(hash_hmac('sha256', $string, $key), $d['signature'])
&& abs(time() - (int) $d['timestamp']) <= 300;
Η ΑΠΑΝΤΗΣΗ
Απαντήστε με HTTP 200 και σώμα JSON. Για να εγκρίνετε, απαντήστε accept true. Για να αρνηθείτε, απαντήστε accept false μαζί με έναν λόγο (reason).
{
"accept": true
}
{
"accept": false,
"reason": "insufficient_funds"
}
| Λόγος | Σημασία |
|---|---|
| insufficient_funds | Ο πελάτης σας δεν έχει αρκετό υπόλοιπο για αυτή την υποπαραγγελία |
| parent_not_active | Η συνδρομή δεν είναι ενεργή στο πάνελ σας (έχει λήξει, ακυρωθεί ή παυθεί) |
| quantity_out_of_range | Η ποσότητα είναι εκτός του ελάχιστου και του μέγιστου της συνδρομής |
| limit_reached | Όλες οι αναρτήσεις αυτής της συνδρομής έχουν ήδη παραγγελίες στο πάνελ σας |
| unknown_parent | Η συνδρομή δεν αναγνωρίζεται ή η υπογραφή δεν είναι έγκυρη |
| error | Το πάνελ σας είχε εσωτερικό σφάλμα (Οποιοσδήποτε άλλος λόγος αντιμετωπίζεται επίσης ως σφάλμα) |
Κανόνες για το endpoint σας
Ένα αίτημα που απορρίφθηκε ή απέτυχε δεν δημιουργεί τίποτα από την πλευρά μας, και ο διαχειριστής μας βλέπει τον λόγο. Μετά από άρνηση, ο διαχειριστής μας μπορεί να προσπαθήσει ξανά αργότερα, δημιουργώντας ξανά την υποπαραγγελία ως νέο αίτημα.
Αν ο διαχειριστής μας θέσει τη συνδρομή σε παύση, θα τη δείτε ως Paused στην κατάσταση της συνδρομής (αν ελέγξετε την κατάσταση της γονικής παραγγελίας). Οι υποπαραγγελίες δεν δημιουργούνται όσο είναι σε παύση. Για να συνεχιστεί, επικοινωνήστε μαζί μας.
Χρησιμοποιήστε αυτή τη μέθοδο για να λάβετε την κατάσταση οποιασδήποτε από τις παραγγελίες σας.
Όταν ελέγχετε την κατάσταση παραγγελίας, σας παρακαλούμε να μην το κάνετε υπερβολικά συχνά, διαφορετικά ενδέχεται να χρειαστεί να περιορίσουμε τα αιτήματά σας.
| Παράμετροι | Περιγραφές |
|---|---|
| api_token | Το API token σας |
| action | Όνομα Μεθόδου |
| order | ID Παραγγελίας |
Παραγγελίες Drip Feed: χρησιμοποιήστε το αναγνωριστικό παραγγελίας που επιστρέφει το add. Το status περιγράφει ολόκληρη την παραγγελία. Όσο εκτελείται, επιστρέφει In Progress. Το start_counter είναι η τιμή στην αρχή της πρώτης εκτέλεσης και το remains είναι η ποσότητα που δεν έχει ακόμη παραδοθεί (εκτελέσεις που δεν έχουν ξεκινήσει συν ό,τι απομένει στις εκτελέσεις που έχουν ήδη ξεκινήσει). Όταν η παραγγελία τελειώσει, επιστρέφει Completed, Partial ή Cancelled και το remains είναι η τελική ποσότητα που δεν παραδόθηκε.
Ακύρωση: μια παραγγελία με κατάσταση Cancelling δεν είναι ακόμη τελική. Συνεχίστε να ελέγχετε την κατάστασή της μέχρι να αλλάξει σε Cancelled ή Partial και επιστρέψτε χρήματα στον πελάτη σας μόνο βάσει αυτής της τελικής απάντησης.
Απάντηση Επιτυχίας:
{
"status": "Completed",
"start_counter": "600",
"remains": "600",
"charge": "0.25845",
"currency": "USD"
}
Παραγγελία σταδιακής παράδοσης:
{
"status": "Completed",
"start_counter": "600",
"remains": "0",
"charge": "2.40000",
"currency": "USD",
"runs": "3",
"orders": ["14286", "14287", "14288"]
}
Παραγγελία αυτόματης συνδρομής. Κάθε ID στα πεδία "orders" και "old_orders" αντιστοιχεί σε κανονική παραγγελία, επομένως μπορείτε να ελέγχετε την κατάστασή της ξεχωριστά. Τα πεδία "posts" και "old_posts" δείχνουν τον αριθμό των αναρτήσεων που έχουν παραδοθεί μέχρι στιγμής, ενώ το "expired" είναι true μόλις παρέλθει η ημερομηνία λήξης. Η κατάσταση παραμένει In progress μέχρι να ολοκληρωθεί η τελευταία ενεργή παραγγελία και στη συνέχεια γίνεται Completed, Partial ή Cancelled:
{
"status": "Inprogress",
"expiry": "2027-12-31",
"expired": false,
"posts": 1,
"old_posts": 1,
"orders": ["14255"],
"old_orders": ["14256"]
}
Υπο-παραγγελία αυτόματης συνδρομής (ένα ID από τα "orders" ή "old_orders"). Η ποσότητα κάθε τέτοιας παραγγελίας επιλέγεται μεταξύ του ελάχιστου και του μέγιστου που ορίζετε, επομένως η κατάστασή της επιστρέφει επίσης "quantity":
{
"status": "Completed",
"start_counter": "1200",
"remains": "0",
"charge": "0.02625",
"currency": "USD",
"quantity": "100"
}
Μια παραγγελία μπορεί να ακυρωθεί αυτόματα μέσω API εάν το "Start Count" είναι ακόμα κενό (η ακύρωση και επιστροφή χρημάτων διαρκεί 10-20 λεπτά). Μόλις ενημερωθεί το "Start Count", η εργασία στην παραγγελία έχει ξεκινήσει και δεν μπορεί πλέον να ακυρωθεί αυτόματα μέσω API.
Για παραγγελίες που έχουν ξεκινήσει, ενδέχεται να μπορούμε ακόμα να τις ακυρώσουμε χειροκίνητα, αλλά θα πρέπει να ζητήσετε ακύρωση μέσω Άνοιγμα Ticket.
| Παράμετροι | Περιγραφές |
|---|---|
| api_token | Το API token σας |
| action | Όνομα Μεθόδου |
| order | ID(s) Παραγγελίας, διαχωρισμένα με κόμμα, έως 100 ID |
Παραγγελίες Drip Feed: ένα αίτημα ακύρωσης γίνεται πάντα δεκτό. Αν δεν υπάρχει ενεργή εκτέλεση, η παραγγελία οριστικοποιείται άμεσα και οι εκτελέσεις που δεν ξεκίνησαν ποτέ επιστρέφονται. Αν υπάρχει ενεργή εκτέλεση, η παραγγελία εμφανίζει Cancelling μέχρι να ολοκληρωθεί αυτή η εκτέλεση και στη συνέχεια καταλήγει σε Cancelled (δεν παραδόθηκε τίποτα) ή Partial. Χρησιμοποιήστε το status για να διαβάσετε το τελικό remains.
Μπορείτε επίσης να ακυρώσετε μια αυτόματη συνδρομή. Δεν δημιουργούνται νέες παραγγελίες και η κατάστασή της εμφανίζεται ως «Cancelling» μέχρι να ολοκληρωθούν οι ενεργές παραγγελίες της. Η τελική κατάσταση γίνεται Cancelled εάν δεν έχει παραδοθεί τίποτα, διαφορετικά γίνεται Partial.
Παράδειγμα Απάντησης:
[
{
"order": 721,
"cancel": 1,
"message": "We are now attempting to cancel your order..."
},
{
"order": 722,
"errors": ["This order cannot be cancelled because its current status is COMPLETED."]
}
]
Ζητήστε αναπλήρωση για μία παραγγελία ή για πολλές παραγγελίες ταυτόχρονα. Μόνο οι υπηρεσίες με "refill": true το υποστηρίζουν και οι αναπληρώσεις είναι διαθέσιμες για περιορισμένο χρονικό διάστημα μετά την ολοκλήρωση μιας παραγγελίας.
| Παράμετροι | Περιγραφές |
|---|---|
| api_token | Το API token σας |
| action | Όνομα Μεθόδου |
| order | ID Παραγγελίας |
| orders | ID(s) Παραγγελίας, διαχωρισμένα με κόμμα, έως 100 ID |
Παράδειγμα Απάντησης:
{
"refill": "1"
}
[
{
"order": 1,
"refill": 1
},
{
"order": 2,
"refill": {
"error": "Incorrect order ID"
}
}
]
Ελέγξτε την κατάσταση μίας αναπλήρωσης ή πολλών ταυτόχρονα. Statuses: Pending, In progress, Completed, Rejected.
| Παράμετροι | Περιγραφές |
|---|---|
| api_token | Το API token σας |
| action | Όνομα Μεθόδου |
| refill | ID αναπλήρωσης |
| refills | ID αναπληρώσεων (διαχωρισμένα με κόμμα, έως 100 ID) |
Παράδειγμα Απάντησης:
{
"status": "Completed"
}
[
{
"refill": 1,
"status": "Completed"
},
{
"refill": 2,
"status": {
"error": "Refill not found"
}
}
]
Αυτό θα επιστρέψει όλες τις ενεργές υπηρεσίες με τις τιμές και τις παραμέτρους τους που είναι διαθέσιμες για τον λογαριασμό σας. Θα περιέχει όλες τις απαραίτητες πληροφορίες για την αυτόματη ρύθμιση ή τον προσδιορισμό τιμών.
Για τις υπηρεσίες συνδρομής, οι τιμές min και max καθορίζουν τα όρια της ποσότητας ανά ανάρτηση.
| Παράμετροι | Περιγραφές |
|---|---|
| api_token | Το API token σας |
| action | Όνομα Μεθόδου |
Παράδειγμα Απάντησης:
[
{
"id": 101,
"service_id": 1,
"name": "Real & Active Followers - Best Server",
"rate": "250.00",
"min": "100",
"max": "100000",
"service": "Instagram Followers",
"type": "default",
"refill": true,
"cancel": true,
"dripfeed": false,
"subscription": false,
"paragraphs": false,
"desc": "0-3 Hours Start | Full Link | 20 Days Refill\r\nLink Format:\r\nhttps://www.instagram.com/official_social_sale/"
},
{
"id": 107,
"service_id": 1,
"name": "Indian Mixed Followers",
"rate": "150.00",
"min": "200",
"max": "10000",
"service": "Instagram Followers",
"type": "default",
"refill": false,
"cancel": false,
"dripfeed": true,
"subscription": false,
"paragraphs": false,
"desc": "0-12 Hours Start | Full Link |\r\nLink Format:\r\nhttps://www.instagram.com/official_social_sale/"
},
{
"id": 30067,
"service_id": 1,
"name": "Instagram Followers - Worldwide",
"rate": "103.00",
"min": "100",
"max": "10000",
"service": "Instagram Followers",
"type": "default",
"refill": false,
"cancel": true,
"dripfeed": false,
"subscription": false,
"paragraphs": false,
"desc": "10k/day\r\nMax - 55k\r\n8 Hours Start"
},
{
"id": 85,
"service_id": 12,
"name": "Facebook Auto Likes",
"rate": "35.00",
"min": "50",
"max": "10000",
"service": "Auto Subscription",
"type": "default",
"refill": false,
"cancel": true,
"dripfeed": false,
"subscription": true,
"paragraphs": false,
"desc": "Likes on every new post\r\nUse the subscription parameters to order"
}
]
Χρησιμοποιείται για τη λήψη του ποσού των διαθέσιμων κεφαλαίων στον λογαριασμό σας.
| Παράμετροι | Περιγραφές |
|---|---|
| api_token | Το API token σας |
| action | Όνομα Μεθόδου |
Παράδειγμα Απάντησης:
{
"balance": "100.78",
"currency": "USD"
}