API Wizard4SocialMedia ће вам омогућити да комуницирате са нашим сајтом једноставним слањем захтева нашем серверу. Ова услуга се нуди бесплатно.
Можете аутоматизовати наручивање, пратити статус испоруке, пратити тренутна средства и програмски приступити свим информацијама о нашим услугама. Идеално за препродавце који воде сопствене панеле, агенције које управљају великим бројем клијената, или програмере који праве прилагођена решења.
| HTTP Метода | POST |
| API URL | https://wizard4socialmedia.com/api/v2 |
| API Кључ | Набавите API кључ на страници Налог |
| Формат Одговора | JSON |
| Пример PHP Кода | https://wizard4socialmedia.com/example.txt |
Користите ову методу да направите нову поруџбину за било коју активну услугу.
| Параметри | Описи |
|---|---|
| api_token | Ваш API токен |
| action | Назив Методе |
| service | ID услуге |
| link | Линк ка страници |
| quantity | Потребна количина |
Одговор при Успеху:
{
"order":"23501"
}
Када поручите претплату БЕЗ опционалног параметра callback, ми креирамо сваку подпоруџбину на нашој страни чим дође њено време, а ваш панел се не контактира. Ваша је обавеза да наплатите свог клијента за њу.
Када поручите претплату СА опционалним параметром callback, тражимо одобрење вашег панела пре креирања сваке подпоруџбине. Подпоруџбина се креира само ако ваш панел одговори да.
Ово вам омогућава да наплатите свог клијента у тренутку када се свака подпоруџбина креира. Без тога, претплата може да креира подпоруџбине на нашој страни док ваш клијент нема стање на вашем панелу, а ви бисте плаћали поруџбине које не можете да наплатите. Са callback-ом, ваш панел одлучује први: ако ваш клијент не може да плати, подпоруџбина се никада не креира.
ЗАХТЕВ
Шаљемо један POST захтев на вашу callback адресу са JSON телом. Адреса мора да користи https на јавном хосту, са подразумеваним портом и без акредитива. Не пратимо преусмеравања.
| Параметри | Описи |
|---|---|
| parent | ID поруџбине претплате на нашој страни, као што је враћен када сте поручили |
| order | ID подпоруџбине на нашој страни (користите га да препознате поновљена питања) |
| 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 токен |
| 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-ја.
За поруџбине које су већ покренуте, можда ћемо и даље моћи да их откажемо ручно, али ћете морати да затражите отказивање путем Отварање Тикета.
| Параметри | Описи |
|---|---|
| api_token | Ваш API токен |
| action | Назив Методе |
| order | ID(-еви) Поруџбине, одвојени зарезом, до 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 токен |
| action | Назив Методе |
| order | ID Поруџбине |
| orders | ID(-еви) Поруџбине, одвојени зарезом, до 100 ID-ева |
Пример Одговора:
{
"refill": "1"
}
[
{
"order": 1,
"refill": 1
},
{
"order": 2,
"refill": {
"error": "Incorrect order ID"
}
}
]
Проверите статус једне или више допуна истовремено. Statuses: Pending, In progress, Completed, Rejected.
| Параметри | Описи |
|---|---|
| api_token | Ваш API токен |
| 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 токен |
| 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 токен |
| action | Назив Методе |
Пример Одговора:
{
"balance": "100.78",
"currency": "USD"
}