services, add, status, refill, refill_status, cancel, balance — POST https://webkit.guru/api/v2

Програмерима

API за препродавце и аутоматизацију

Једна HTTP адреса покрива цео циклус: добити каталог, креирати наруџбу, сазнати статус, затражити Refill или отказивање. Протокол се подудара са форматом који већина SMM панела користи, тако да готовој интеграцији обично треба само промена адресе и кључа.

Адреса

POST https://webkit.guru/api/v2

Само POST. Тело се може слати као application/x-www-form-urlencoded или као application/json — прихватају се оба формата, одговор је увек JSON.

Аутентификација

Кључ се шаље у телу захтева пољем key. Код нас се чува само његов SHA-256 хеш, тако да се кључ не може опоравити из базе — ако се изгуби, издајте нови. Деактивирати кључ можете у контролној табли у било ком тренутку, престаје да ради одмах.

Ограничење учесталости

60 захтева у минуту са једне IP адресе. При прекорачењу долази кôд 429 и заглавље Retry-After са бројем секунди до следећег покушаја. Статуси се боље тражити у групама преко orders, а не по једну наруџбу по позиву.

Методе

action=services

Листа услуга

The full catalogue with prices, limits and refill flags. Prices already include your markup — these are the amounts charged to your balance.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “services”

Одговор

[
  {
    "service": 21251,
    "name": "Telegram Views",
    "type": "Default",
    "category": "Telegram",
    "rate": 0.41,
    "min": 10,
    "max": 50000000,
    "refill": true,
    "cancel": true
  }
]

action=add

Креирај наруџбу

Charges your balance and queues the order. If the provider rejects it, the amount is refunded automatically.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “add”
service	int	да	Service ID from the services method
link	string	да	Link to the profile or post. The format is validated per platform and metric
quantity	int	да	Quantity within the service min and max
runs	int	не	Drip-feed: how many runs
interval	int	не	Drip-feed: interval between runs, in minutes

Одговор

{ "order": 84213 }

action=status

Статус наруџбе

A single order via order, or up to a hundred at once via orders.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “status”
order	int	не	Број наруџбе
orders	int[]	не	Comma-separated IDs, up to 100

Одговор

{
  "charge": "410.00",
  "start_count": "15420",
  "status": "in_progress",
  "remains": "3180",
  "currency": "RUB"
}

Одговор за пакет

{
  "84213": { "charge": "410.00", "status": "completed",   "remains": "0",    "start_count": "15420", "currency": "RUB" },
  "84214": { "charge": "120.00", "status": "in_progress", "remains": "890",  "start_count": "2310",  "currency": "RUB" },
  "84215": { "error": "Incorrect order ID" }
}

action=refill

Затражи Refill

Available for services flagged refill. Returns a refill ID to check the status with.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “refill”
order	int	не	Број наруџбе
orders	int[]	не	Comma-separated IDs, up to 100

Одговор

{ "refill": 1932 }

Одговор за пакет

[
  { "order": 84213, "refill": 1932 },
  { "order": 84214, "error": "Order is not sent to provider yet" }
]

action=refill_status

Refill status

The ID is ours, not the provider's — you never need to know which supplier fulfils the order.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “refill_status”
refill	int	не	Refill ID
refills	int[]	не	Comma-separated IDs, up to 100

Одговор

{ "status": "Completed" }

Одговор за пакет

[
  { "refill": 1932, "status": "Completed" },
  { "refill": 1933, "status": "Pending" }
]

action=cancel

Откажи наруџбу

The provider may refuse a cancellation, so the order moves to cancel_requested. The actual cancellation and refund are confirmed by status sync.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “cancel”
order	int	не	Број наруџбе
orders	int[]	не	Comma-separated IDs, up to 100

Одговор

{ "cancel": 1 }

Одговор за пакет

[
  { "order": 84213, "cancel": 1 },
  { "order": 84214, "error": "Incorrect order ID" }
]

action=balance

Balance

Current account balance, in rubles.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “balance”

Одговор

{ "balance": "12480.50", "currency": "RUB" }

Примери кôда

cURL

curl -X POST https://webkit.guru/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=21251 \
  -d link=https://t.me/example/42 \
  -d quantity=1000

PHP

<?php
$response = file_get_contents('https://webkit.guru/api/v2', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query([
            'key'      => 'YOUR_KEY',
            'action'   => 'add',
            'service'  => 21251,
            'link'     => 'https://t.me/example/42',
            'quantity' => 1000,
        ]),
    ],
]));

$order = json_decode($response, true);

Python

import requests

response = requests.post("https://webkit.guru/api/v2", data={
    "key": "YOUR_KEY",
    "action": "add",
    "service": 21251,
    "link": "https://t.me/example/42",
    "quantity": 1000,
})

order = response.json()

JavaScript

const response = await fetch("https://webkit.guru/api/v2", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    key: "YOUR_KEY",
    action: "add",
    service: 21251,
    link: "https://t.me/example/42",
    quantity: 1000,
  }),
});

const order = await response.json();

Статуси наруџбе

Поље status методе status враћа једну од ових вредности.

pending: Accepted by the panel, not yet sent to the provider
in_progress: У току
processing: Provider accepted it, delivery is about to start
completed: Fully delivered
partial: Partially delivered, the difference is refunded
cancel_requested: Cancellation requested, waiting for the provider
canceled: Cancelled, funds returned
failed: Could not be fulfilled, funds returned

Грешке

Грешке пословне логике долазе са кôдом 200 и пољем error. HTTP кôдовима одговарају само аутентификација и ограничење учесталости.

401 · Invalid API key: The key is unknown or has been disabled in the dashboard
429 · Rate limit exceeded: More than 60 requests per minute from one address. The response carries a Retry-After header
Incorrect order ID: No order with this ID belongs to your account
Unknown action: The action value is not one of those listed above

Спремни да се повежете?

Региструјте се, допуните баланс и издајте кључ на картици „API”. Засебно одобрење није потребно.

Креирај налог

Програмерима

API за препродавце и аутоматизацију

Адреса

POST https://webkit.guru/api/v2

Аутентификација

Ограничење учесталости

Методе

action=services

Листа услуга

The full catalogue with prices, limits and refill flags. Prices already include your markup — these are the amounts charged to your balance.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “services”

Одговор

[
  {
    "service": 21251,
    "name": "Telegram Views",
    "type": "Default",
    "category": "Telegram",
    "rate": 0.41,
    "min": 10,
    "max": 50000000,
    "refill": true,
    "cancel": true
  }
]

action=add

Креирај наруџбу

Charges your balance and queues the order. If the provider rejects it, the amount is refunded automatically.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “add”
service	int	да	Service ID from the services method
link	string	да	Link to the profile or post. The format is validated per platform and metric
quantity	int	да	Quantity within the service min and max
runs	int	не	Drip-feed: how many runs
interval	int	не	Drip-feed: interval between runs, in minutes

Одговор

{ "order": 84213 }

action=status

Статус наруџбе

A single order via order, or up to a hundred at once via orders.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “status”
order	int	не	Број наруџбе
orders	int[]	не	Comma-separated IDs, up to 100

Одговор

{
  "charge": "410.00",
  "start_count": "15420",
  "status": "in_progress",
  "remains": "3180",
  "currency": "RUB"
}

Одговор за пакет

{
  "84213": { "charge": "410.00", "status": "completed",   "remains": "0",    "start_count": "15420", "currency": "RUB" },
  "84214": { "charge": "120.00", "status": "in_progress", "remains": "890",  "start_count": "2310",  "currency": "RUB" },
  "84215": { "error": "Incorrect order ID" }
}

action=refill

Затражи Refill

Available for services flagged refill. Returns a refill ID to check the status with.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “refill”
order	int	не	Број наруџбе
orders	int[]	не	Comma-separated IDs, up to 100

Одговор

{ "refill": 1932 }

Одговор за пакет

[
  { "order": 84213, "refill": 1932 },
  { "order": 84214, "error": "Order is not sent to provider yet" }
]

action=refill_status

Refill status

The ID is ours, not the provider's — you never need to know which supplier fulfils the order.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “refill_status”
refill	int	не	Refill ID
refills	int[]	не	Comma-separated IDs, up to 100

Одговор

{ "status": "Completed" }

Одговор за пакет

[
  { "refill": 1932, "status": "Completed" },
  { "refill": 1933, "status": "Pending" }
]

action=cancel

Откажи наруџбу

The provider may refuse a cancellation, so the order moves to cancel_requested. The actual cancellation and refund are confirmed by status sync.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “cancel”
order	int	не	Број наруџбе
orders	int[]	не	Comma-separated IDs, up to 100

Одговор

{ "cancel": 1 }

Одговор за пакет

[
  { "order": 84213, "cancel": 1 },
  { "order": 84214, "error": "Incorrect order ID" }
]

action=balance

Balance

Current account balance, in rubles.

Параметар	Тип	Обавезан	Опис
key	string	да	API key from your dashboard, “API” tab
action	string	да	The string “balance”

Одговор

{ "balance": "12480.50", "currency": "RUB" }

Примери кôда

cURL

curl -X POST https://webkit.guru/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=21251 \
  -d link=https://t.me/example/42 \
  -d quantity=1000

PHP

<?php
$response = file_get_contents('https://webkit.guru/api/v2', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query([
            'key'      => 'YOUR_KEY',
            'action'   => 'add',
            'service'  => 21251,
            'link'     => 'https://t.me/example/42',
            'quantity' => 1000,
        ]),
    ],
]));

$order = json_decode($response, true);

Python

import requests

response = requests.post("https://webkit.guru/api/v2", data={
    "key": "YOUR_KEY",
    "action": "add",
    "service": 21251,
    "link": "https://t.me/example/42",
    "quantity": 1000,
})

order = response.json()

JavaScript

const response = await fetch("https://webkit.guru/api/v2", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    key: "YOUR_KEY",
    action: "add",
    service: 21251,
    link: "https://t.me/example/42",
    quantity: 1000,
  }),
});

const order = await response.json();

Статуси наруџбе

Поље status методе status враћа једну од ових вредности.

pending: Accepted by the panel, not yet sent to the provider
in_progress: У току
processing: Provider accepted it, delivery is about to start
completed: Fully delivered
partial: Partially delivered, the difference is refunded
cancel_requested: Cancellation requested, waiting for the provider
canceled: Cancelled, funds returned
failed: Could not be fulfilled, funds returned

Грешке

401 · Invalid API key: The key is unknown or has been disabled in the dashboard
429 · Rate limit exceeded: More than 60 requests per minute from one address. The response carries a Retry-After header
Incorrect order ID: No order with this ID belongs to your account
Unknown action: The action value is not one of those listed above

Спремни да се повежете?

Региструјте се, допуните баланс и издајте кључ на картици „API”. Засебно одобрење није потребно.

Креирај налог