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

Razvijalcem

API za preprodajalce in avtomatizacijo

En naslov HTTP pokriva celoten potek: pridobi katalog, ustvari naročilo, preveri status, zahtevaj Refill ali preklic. Protokol se ujema s formatom, ki ga uporablja večina SMM-plošč, zato obstoječi integraciji običajno zadostuje sprememba naslova in ključa.

Naslov

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

Samo POST. Telo lahko pošlješ kot application/x-www-form-urlencoded ali kot application/json – sprejeta sta oba formata, odgovor je vedno JSON.

Avtentikacija

Ključ se pošlje v telesu zahteve s poljem key. Pri nas shranjujemo samo njegov zgor SHA-256, zato ključa iz baze ni mogoče obnoviti – če ga izgubiš, izdaj novega. Ključ lahko kadar koli onemogočiš v nadzorni plošči, takoj preneha delovati.

Omejitev pogostosti

60 zahtevkov na minuto z enega naslova IP. Pri preseženju pride koda 429 in glava Retry-After s številom sekund do naslednjega poskusa. Statuse bolje povprašuj v paketih prek orders, ne pa po eno naročilo na klic.

Metode

action=services

Seznam storitev

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “services”

Odgovor

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

action=add

Ustvari naročilo

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

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

Odgovor

{ "order": 84213 }

action=status

Status naročila

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “status”
order	int	ne	ID naročila
orders	int[]	ne	Comma-separated IDs, up to 100

Odgovor

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

Odgovor za paket

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

Zahtevaj Refill

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “refill”
order	int	ne	ID naročila
orders	int[]	ne	Comma-separated IDs, up to 100

Odgovor

{ "refill": 1932 }

Odgovor za paket

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “refill_status”
refill	int	ne	Refill ID
refills	int[]	ne	Comma-separated IDs, up to 100

Odgovor

{ "status": "Completed" }

Odgovor za paket

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

action=cancel

Prekliči naročilo

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “cancel”
order	int	ne	ID naročila
orders	int[]	ne	Comma-separated IDs, up to 100

Odgovor

{ "cancel": 1 }

Odgovor za paket

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

action=balance

Stanje

Current account balance, in rubles.

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “balance”

Odgovor

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

Primeri kode

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

Statusi naročila

Polje status metode status vrne eno od teh vrednosti.

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

Napake

Napake poslovne logike prihajajo s kodo 200 in poljem error. S kodami HTTP odgovarjata samo avtentikacija in omejitev pogostosti.

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

Pripravljen na povezavo?

Registriraj se, naloži stanje in izdaj ključ na zavihku “API”. Posebnega odobrenja ni treba.

Ustvari račun

Razvijalcem

API za preprodajalce in avtomatizacijo

Naslov

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

Samo POST. Telo lahko pošlješ kot application/x-www-form-urlencoded ali kot application/json – sprejeta sta oba formata, odgovor je vedno JSON.

Avtentikacija

Omejitev pogostosti

Metode

action=services

Seznam storitev

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “services”

Odgovor

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

action=add

Ustvari naročilo

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

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

Odgovor

{ "order": 84213 }

action=status

Status naročila

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “status”
order	int	ne	ID naročila
orders	int[]	ne	Comma-separated IDs, up to 100

Odgovor

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

Odgovor za paket

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

Zahtevaj Refill

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “refill”
order	int	ne	ID naročila
orders	int[]	ne	Comma-separated IDs, up to 100

Odgovor

{ "refill": 1932 }

Odgovor za paket

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “refill_status”
refill	int	ne	Refill ID
refills	int[]	ne	Comma-separated IDs, up to 100

Odgovor

{ "status": "Completed" }

Odgovor za paket

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

action=cancel

Prekliči naročilo

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

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “cancel”
order	int	ne	ID naročila
orders	int[]	ne	Comma-separated IDs, up to 100

Odgovor

{ "cancel": 1 }

Odgovor za paket

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

action=balance

Stanje

Current account balance, in rubles.

Parameter	Vrsta	Obvezno	Opis
key	string	da	API key from your dashboard, “API” tab
action	string	da	The string “balance”

Odgovor

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

Primeri kode

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

Statusi naročila

Polje status metode status vrne eno od teh vrednosti.

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

Napake

Napake poslovne logike prihajajo s kodo 200 in poljem error. S kodami HTTP odgovarjata samo avtentikacija in omejitev pogostosti.

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

Pripravljen na povezavo?

Registriraj se, naloži stanje in izdaj ključ na zavihku “API”. Posebnega odobrenja ni treba.

Ustvari račun