Λεπτομέρειες API

Το 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Όνομα Μεθόδου
serviceID υπηρεσίας
linkΣύνδεσμος σελίδας
quantityΑπαιτούμενη ποσότητα

Απάντηση Επιτυχίας:

{
  "order":"23501"
}
Callback Έγκρισης Συνδρομής

Όταν υποβάλλετε παραγγελία συνδρομής ΧΩΡΙΣ την προαιρετική παράμετρο callback, δημιουργούμε κάθε υποπαραγγελία από την πλευρά μας μόλις φτάσει η ώρα της και το πάνελ σας δεν ειδοποιείται. Εσείς είστε υπεύθυνοι να χρεώσετε τον δικό σας πελάτη γι' αυτήν.

Όταν υποβάλλετε παραγγελία συνδρομής ΜΕ την προαιρετική παράμετρο callback, ζητάμε την έγκριση του πάνελ σας πριν δημιουργήσουμε κάθε υποπαραγγελία. Η υποπαραγγελία δημιουργείται μόνο αν το πάνελ σας απαντήσει ναι.

Έτσι μπορείτε να χρεώνετε τον δικό σας πελάτη τη στιγμή που δημιουργείται κάθε υποπαραγγελία. Χωρίς αυτό, μια συνδρομή μπορεί να δημιουργεί υποπαραγγελίες από την πλευρά μας ενώ ο πελάτης σας δεν έχει υπόλοιπο στο πάνελ σας, και εσείς θα πληρώνατε παραγγελίες που δεν μπορείτε να χρεώσετε. Με το callback, το πάνελ σας αποφασίζει πρώτο: αν ο πελάτης σας δεν μπορεί να πληρώσει, η υποπαραγγελία δεν δημιουργείται ποτέ.


ΤΟ ΑΙΤΗΜΑ

Στέλνουμε ένα αίτημα POST στη διεύθυνση callback σας με σώμα JSON. Η διεύθυνση πρέπει να χρησιμοποιεί https σε δημόσιο host, με την προεπιλεγμένη θύρα και χωρίς διαπιστευτήρια. Δεν ακολουθούμε ανακατευθύνσεις.

Παράμετροι Περιγραφές
parentΤο αναγνωριστικό της παραγγελίας συνδρομής από την πλευρά μας, όπως επιστράφηκε όταν υποβάλατε την παραγγελία
orderΤο αναγνωριστικό της υποπαραγγελίας από την πλευρά μας (Χρησιμοποιήστε το για να αναγνωρίζετε επαναλαμβανόμενες ερωτήσεις)
linkΟ σύνδεσμος της ανάρτησης για την οποία προορίζεται η υποπαραγγελία
quantityΗ ποσότητα της υποπαραγγελίας
is_old1 αν η υποπαραγγελία αφορά παλιά ανάρτηση, 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 σας

  • Απορρίψτε αιτήματα των οποίων το timestamp (η ώρα που στείλαμε το αίτημα) διαφέρει από την τρέχουσα ώρα σας περισσότερο από 5 λεπτά.
  • Αν ερωτηθείτε ξανά για το ίδιο αναγνωριστικό παραγγελίας που έχετε ήδη εγκρίνει, απαντήστε ξανά ναι και μην χρεώσετε δεύτερη φορά.
  • Χρεώστε τον πελάτη σας και καταγράψτε την υποπαραγγελία σε ένα βήμα, και εγκρίνετε μόνο αν αυτό πέτυχε.
  • Απαντήστε εντός 8 δευτερολέπτων. Μια λήξη χρόνου, μια μη έγκυρη απάντηση ή ένα σφάλμα HTTP θεωρείται άρνηση.
  • Εγκρίνετε μόνο συνδρομές και ποσότητες που ταιριάζουν με όσα παραγγέλθηκαν.

Ένα αίτημα που απορρίφθηκε ή απέτυχε δεν δημιουργεί τίποτα από την πλευρά μας, και ο διαχειριστής μας βλέπει τον λόγο. Μετά από άρνηση, ο διαχειριστής μας μπορεί να προσπαθήσει ξανά αργότερα, δημιουργώντας ξανά την υποπαραγγελία ως νέο αίτημα.

Αν ο διαχειριστής μας θέσει τη συνδρομή σε παύση, θα τη δείτε ως 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Όνομα Μεθόδου
orderID Παραγγελίας
ordersID(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Όνομα Μεθόδου
refillID αναπλήρωσης
refillsID αναπληρώσεων (διαχωρισμένα με κόμμα, έως 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"
}