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

Per a desenvolupadors

API per a revensors i automatització

Una sola adreça HTTP cobreix tot el cicle: obtenir el catàleg, crear comandes, consultar l'estat, sol·licita reposició o cancel·lació. El protocol coincideix amb el format que usen la majoria de panells SMM, de manera que una integració existent normalment només necessita canviar l'adreça i la clau.

Adreça

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

Només POST. El cos es pot enviar com a application/x-www-form-urlencoded o com a application/json — s'admeten tots dos formats; la resposta sempre és JSON.

Autenticació

La clau viatja al cos de la sol·licitud com a camp key. Nosaltres només en guardem el hash SHA-256, de manera que la clau no es pot recuperar de la nostra base de dades — si la perds, emet-ne una de nova. Una clau es pot revocar des del tauler en qualsevol moment i deixa de funcionar de seguida.

Límit de freqüència

60 sol·licituds per minut des d'una adreça IP. Per sobre d'això, l'endpoint respon 429 i inclou una capçalera Retry-After amb el nombre de segons a esperar. Consulta els estats en lots via orders en lloc d'una crida per comanda.

Mètodes

action=services

Llista de serveis

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “services”

Resposta

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

action=add

Crea una comanda

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “add”
service	int	sí	Service ID from the services method
link	string	sí	Link to the profile or post. The format is validated per platform and metric
quantity	int	sí	Quantity within the service min and max
runs	int	no	Drip-feed: how many runs
interval	int	no	Drip-feed: interval between runs, in minutes

Resposta

{ "order": 84213 }

action=status

Estat de la comanda

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “status”
order	int	no	ID de comanda
orders	int[]	no	Comma-separated IDs, up to 100

Resposta

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

Resposta per lots

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

Sol·licita reposició

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “refill”
order	int	no	ID de comanda
orders	int[]	no	Comma-separated IDs, up to 100

Resposta

{ "refill": 1932 }

Resposta per lots

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “refill_status”
refill	int	no	Refill ID
refills	int[]	no	Comma-separated IDs, up to 100

Resposta

{ "status": "Completed" }

Resposta per lots

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

action=cancel

Cancel·la la comanda

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “cancel”
order	int	no	ID de comanda
orders	int[]	no	Comma-separated IDs, up to 100

Resposta

{ "cancel": 1 }

Resposta per lots

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

action=balance

Saldo

Current account balance, in rubles.

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “balance”

Resposta

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

Exemples de codi

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

Estats de la comanda

El camp status del mètode status retorna un d'aquests valors.

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

Errors

Els errors de lògica de negoci arriben amb codi 200 i un camp error. Només l'autenticació i el límit de freqüècia usen codis d'estat 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

Llest per a connectar?

Crea un compte, recarrega el saldo i emet una clau a la pestanya «API». No cal cap aprovació separada.

Crea un compte

Per a desenvolupadors

API per a revensors i automatització

Adreça

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

Només POST. El cos es pot enviar com a application/x-www-form-urlencoded o com a application/json — s'admeten tots dos formats; la resposta sempre és JSON.

Autenticació

Límit de freqüència

Mètodes

action=services

Llista de serveis

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “services”

Resposta

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

action=add

Crea una comanda

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “add”
service	int	sí	Service ID from the services method
link	string	sí	Link to the profile or post. The format is validated per platform and metric
quantity	int	sí	Quantity within the service min and max
runs	int	no	Drip-feed: how many runs
interval	int	no	Drip-feed: interval between runs, in minutes

Resposta

{ "order": 84213 }

action=status

Estat de la comanda

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “status”
order	int	no	ID de comanda
orders	int[]	no	Comma-separated IDs, up to 100

Resposta

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

Resposta per lots

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

Sol·licita reposició

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “refill”
order	int	no	ID de comanda
orders	int[]	no	Comma-separated IDs, up to 100

Resposta

{ "refill": 1932 }

Resposta per lots

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “refill_status”
refill	int	no	Refill ID
refills	int[]	no	Comma-separated IDs, up to 100

Resposta

{ "status": "Completed" }

Resposta per lots

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

action=cancel

Cancel·la la comanda

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

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “cancel”
order	int	no	ID de comanda
orders	int[]	no	Comma-separated IDs, up to 100

Resposta

{ "cancel": 1 }

Resposta per lots

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

action=balance

Saldo

Current account balance, in rubles.

Paràmetre	Tipus	Obligatori	Descripció
key	string	sí	API key from your dashboard, “API” tab
action	string	sí	The string “balance”

Resposta

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

Exemples de codi

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

Estats de la comanda

El camp status del mètode status retorna un d'aquests valors.

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

Errors

Els errors de lògica de negoci arriben amb codi 200 i un camp error. Només l'autenticació i el límit de freqüècia usen codis d'estat 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

Llest per a connectar?

Crea un compte, recarrega el saldo i emet una clau a la pestanya «API». No cal cap aprovació separada.

Crea un compte