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». Не се изисква отделно одобрение.

Създай акаунт