API Детаљи

API Wizard4SocialMedia ће вам омогућити да комуницирате са нашим сајтом једноставним слањем захтева нашем серверу. Ова услуга се нуди бесплатно.

Можете аутоматизовати наручивање, пратити статус испоруке, пратити тренутна средства и програмски приступити свим информацијама о нашим услугама. Идеално за препродавце који воде сопствене панеле, агенције које управљају великим бројем клијената, или програмере који праве прилагођена решења.

HTTP Метода POST
API URL https://wizard4socialmedia.com/api/v2
API Кључ Набавите API кључ на страници Налог
Формат Одговора JSON
Пример PHP Кода https://wizard4socialmedia.com/example.txt
Додај Поруџбину

Користите ову методу да направите нову поруџбину за било коју активну услугу.

Параметри Описи
api_tokenВаш API токен
actionНазив Методе
serviceID услуге
linkЛинк ка страници
quantityПотребна количина

Одговор при Успеху:

{
  "order":"23501"
}
Callback за одобрење претплате

Када поручите претплату БЕЗ опционалног параметра callback, ми креирамо сваку подпоруџбину на нашој страни чим дође њено време, а ваш панел се не контактира. Ваша је обавеза да наплатите свог клијента за њу.

Када поручите претплату СА опционалним параметром callback, тражимо одобрење вашег панела пре креирања сваке подпоруџбине. Подпоруџбина се креира само ако ваш панел одговори да.

Ово вам омогућава да наплатите свог клијента у тренутку када се свака подпоруџбина креира. Без тога, претплата може да креира подпоруџбине на нашој страни док ваш клијент нема стање на вашем панелу, а ви бисте плаћали поруџбине које не можете да наплатите. Са callback-ом, ваш панел одлучује први: ако ваш клијент не може да плати, подпоруџбина се никада не креира.


ЗАХТЕВ

Шаљемо један POST захтев на вашу callback адресу са JSON телом. Адреса мора да користи https на јавном хосту, са подразумеваним портом и без акредитива. Не пратимо преусмеравања.

Параметри Описи
parentID поруџбине претплате на нашој страни, као што је враћен када сте поручили
orderID подпоруџбине на нашој страни (користите га да препознате поновљена питања)
linkЛинк објаве за коју је подпоруџбина намењена
quantityКоличина подпоруџбине
is_old1 ако је подпоруџбина за стару објаву, 0 ако је за нову објаву
timestampUnix време када је захтев упућен
signatureHMAC-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 минута.
  • Ако вас поново питају за исти ID поруџбине који сте већ одобрили, поново одговорите да и немојте наплатити двапут.
  • Наплатите клијента и забележите подпоруџбину у једном кораку, и одобрите само ако је то успело.
  • Одговорите у року од 8 секунди. Истек времена, неважећи одговор или HTTP грешка рачуна се као одбијање.
  • Одобравајте само претплате и количине које одговарају ономе што је поручено.

Одбијен или неуспео захтев не креира ништа на нашој страни, а наш администратор види разлог. После одбијања, наш администратор може да покуша поново касније тако што ће поново креирати подпоруџбину, као нови захтев.

Ако наш администратор паузира претплату, видећете је као 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Назив Методе
orderID Поруџбине
ordersID(-еви) Поруџбине, одвојени зарезом, до 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Назив Методе
refillID допуне
refillsID-ови допуна (одвојени зарезима, до 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"
}