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

Dla programistów

API dla resellerów i automatyzacji

Jeden adres HTTP obsługuje cały cykl: pobranie katalogu, utworzenie zamówienia, sprawdzenie statusu, zgłoszenie refillu lub anulowania. Protokół jest zgodny z formatem większości paneli SMM, więc gotowej integracji zwykle wystarczy zmienić adres i klucz.

Adres

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

Tylko POST. Treść można wysłać jako application/x-www-form-urlencoded lub application/json — oba formaty są akceptowane, odpowiedź zawsze w JSON.

Autoryzacja

Klucz przekazuje się w treści żądania w polu key. Przechowujemy wyłącznie jego skrót SHA-256, więc nie da się go odtworzyć z bazy — w razie utraty wygeneruj nowy. Klucz można wyłączyć w panelu w dowolnym momencie i przestaje działać natychmiast.

Limit zapytań

60 zapytań na minutę z jednego adresu IP. Po przekroczeniu zwracany jest kod 429 i nagłówek Retry-After z liczbą sekund do kolejnej próby. Statusy lepiej pobierać partiami przez orders niż po jednym zamówieniu.

Metody

action=services

Lista usług

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “services”

Odpowiedź

[
  {
    "service": 21251,
    "name": "Telegram — просмотры",
    "type": "Default",
    "category": "Telegram",
    "rate": 0.41,
    "min": 10,
    "max": 50000000,
    "refill": true,
    "cancel": true
  }
]

action=add

Utwórz zamówienie

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “add”
service	int	tak	Service ID from the services method
link	string	tak	Link to the profile or post. The format is validated per platform and metric
quantity	int	tak	Quantity within the service min and max
runs	int	nie	Drip-feed: how many runs
interval	int	nie	Drip-feed: interval between runs, in minutes

Odpowiedź

{ "order": 84213 }

action=status

Status zamówienia

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “status”
order	int	nie	Numer zamówienia
orders	int[]	nie	Comma-separated IDs, up to 100

Odpowiedź

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

Odpowiedź zbiorcza

{
  "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

Poproś o refill

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “refill”
order	int	nie	Numer zamówienia
orders	int[]	nie	Comma-separated IDs, up to 100

Odpowiedź

{ "refill": 1932 }

Odpowiedź zbiorcza

[
  { "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.

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “refill_status”
refill	int	nie	Refill ID
refills	int[]	nie	Comma-separated IDs, up to 100

Odpowiedź

{ "status": "Completed" }

Odpowiedź zbiorcza

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

action=cancel

Anuluj zamówienie

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “cancel”
order	int	nie	Numer zamówienia
orders	int[]	nie	Comma-separated IDs, up to 100

Odpowiedź

{ "cancel": 1 }

Odpowiedź zbiorcza

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

action=balance

Saldo

Current account balance, in rubles.

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “balance”

Odpowiedź

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

Przykłady kodu

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();

Statusy zamówienia

Pole status metody status zwraca jedną z tych wartości.

pending: Accepted by the panel, not yet sent to the provider
in_progress: W trakcie
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

Błędy

Błędy logiki biznesowej przychodzą z kodem 200 i polem error. Kodami HTTP odpowiadają wyłącznie autoryzacja i limit zapytań.

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

Gotowy do integracji?

Zarejestruj się, doładuj saldo i wygeneruj klucz w zakładce „API”. Osobna zgoda nie jest potrzebna.

Utwórz konto

Dla programistów

API dla resellerów i automatyzacji

Adres

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

Tylko POST. Treść można wysłać jako application/x-www-form-urlencoded lub application/json — oba formaty są akceptowane, odpowiedź zawsze w JSON.

Autoryzacja

Limit zapytań

Metody

action=services

Lista usług

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “services”

Odpowiedź

[
  {
    "service": 21251,
    "name": "Telegram — просмотры",
    "type": "Default",
    "category": "Telegram",
    "rate": 0.41,
    "min": 10,
    "max": 50000000,
    "refill": true,
    "cancel": true
  }
]

action=add

Utwórz zamówienie

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “add”
service	int	tak	Service ID from the services method
link	string	tak	Link to the profile or post. The format is validated per platform and metric
quantity	int	tak	Quantity within the service min and max
runs	int	nie	Drip-feed: how many runs
interval	int	nie	Drip-feed: interval between runs, in minutes

Odpowiedź

{ "order": 84213 }

action=status

Status zamówienia

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “status”
order	int	nie	Numer zamówienia
orders	int[]	nie	Comma-separated IDs, up to 100

Odpowiedź

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

Odpowiedź zbiorcza

{
  "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

Poproś o refill

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “refill”
order	int	nie	Numer zamówienia
orders	int[]	nie	Comma-separated IDs, up to 100

Odpowiedź

{ "refill": 1932 }

Odpowiedź zbiorcza

[
  { "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.

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “refill_status”
refill	int	nie	Refill ID
refills	int[]	nie	Comma-separated IDs, up to 100

Odpowiedź

{ "status": "Completed" }

Odpowiedź zbiorcza

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

action=cancel

Anuluj zamówienie

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

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “cancel”
order	int	nie	Numer zamówienia
orders	int[]	nie	Comma-separated IDs, up to 100

Odpowiedź

{ "cancel": 1 }

Odpowiedź zbiorcza

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

action=balance

Saldo

Current account balance, in rubles.

Parametr	Typ	Wymagany	Opis
key	string	tak	API key from your dashboard, “API” tab
action	string	tak	The string “balance”

Odpowiedź

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

Przykłady kodu

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();

Statusy zamówienia

Pole status metody status zwraca jedną z tych wartości.

pending: Accepted by the panel, not yet sent to the provider
in_progress: W trakcie
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

Błędy

Błędy logiki biznesowej przychodzą z kodem 200 i polem error. Kodami HTTP odpowiadają wyłącznie autoryzacja i limit zapytań.

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

Gotowy do integracji?

Zarejestruj się, doładuj saldo i wygeneruj klucz w zakładce „API”. Osobna zgoda nie jest potrzebna.

Utwórz konto