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

Fejlesztőknek

API viszonteladóknak és automatizációhoz

Egyetlen HTTP végpont lefedi a teljes munkafolyamatot: katalógus lekérése, rendelés leadása, állapot ellenőrzése, Refill vagy törlés kérése. A protokoll megegyezik a legtöbb SMM panel által használt formátummal, így egy meglévő integrációnál általában elég csak a végpontot és a kulcsot lecserélni.

Cím

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

Csak POST. A törzs küldhető application/x-www-form-urlencoded vagy application/json formátumban – mindkettő elfogadott, a válasz mindig JSON.

Hitelesítés

A kulcs a kérelem törzsében a key mezőben utazik. Nálunk csak a SHA-256 hash-e tárolódik, ezért a kulcs nem állítható vissza az adatbázisból – ha elveszett, bocsáss ki újat. A kulcs az irányítópulton bármikor visszavonható, és azonnal megszűnik működni.

Frekvencia limit

Percenként 60 kérelem egy IP címről. E felett a végpont 429-cel válaszol, és egy Retry-After fejlécet ad vissza, amely megmondja, hány másodpercet várj. Az állapotokat kötegekben kérd le az orders végponton keresztül, ahelyett, hogy rendelésenként külön hívogatnál.

Metódusok

action=services

Szolgáltatások listája

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “services”

Válasz

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

action=add

Rendelés létrehozása

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “add”
service	int	igen	Service ID from the services method
link	string	igen	Link to the profile or post. The format is validated per platform and metric
quantity	int	igen	Quantity within the service min and max
runs	int	nem	Drip-feed: how many runs
interval	int	nem	Drip-feed: interval between runs, in minutes

Válasz

{ "order": 84213 }

action=status

Rendelés állapota

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “status”
order	int	nem	Rendelés azonosítója
orders	int[]	nem	Comma-separated IDs, up to 100

Válasz

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

Köteges válasz

{
  "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 kérése

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “refill”
order	int	nem	Rendelés azonosítója
orders	int[]	nem	Comma-separated IDs, up to 100

Válasz

{ "refill": 1932 }

Köteges válasz

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “refill_status”
refill	int	nem	Refill ID
refills	int[]	nem	Comma-separated IDs, up to 100

Válasz

{ "status": "Completed" }

Köteges válasz

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

action=cancel

Rendelés törlése

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “cancel”
order	int	nem	Rendelés azonosítója
orders	int[]	nem	Comma-separated IDs, up to 100

Válasz

{ "cancel": 1 }

Köteges válasz

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

action=balance

Egyenleg

Current account balance, in rubles.

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “balance”

Válasz

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

Kódpéldák

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

Rendelés állapotok

A status metódus status mezője ezen értékek egyikét adja vissza.

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

Hibák

Az üzleti logikai hibák HTTP 200-as kóddal és egy error mezővel érkeznek. Csak a hitelesítés és a frekvencia limit HTTP státuszkódokkal válaszol.

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

Készen állsz a csatlakozásra?

Regisztrálj, töltsd fel az egyenlegedet, és bocsáss ki egy kulcsot az „API” fülön. Nincs külön jóváhagyási lépés.

Fiók létrehozása

Fejlesztőknek

API viszonteladóknak és automatizációhoz

Cím

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

Csak POST. A törzs küldhető application/x-www-form-urlencoded vagy application/json formátumban – mindkettő elfogadott, a válasz mindig JSON.

Hitelesítés

Frekvencia limit

Metódusok

action=services

Szolgáltatások listája

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “services”

Válasz

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

action=add

Rendelés létrehozása

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “add”
service	int	igen	Service ID from the services method
link	string	igen	Link to the profile or post. The format is validated per platform and metric
quantity	int	igen	Quantity within the service min and max
runs	int	nem	Drip-feed: how many runs
interval	int	nem	Drip-feed: interval between runs, in minutes

Válasz

{ "order": 84213 }

action=status

Rendelés állapota

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “status”
order	int	nem	Rendelés azonosítója
orders	int[]	nem	Comma-separated IDs, up to 100

Válasz

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

Köteges válasz

{
  "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 kérése

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “refill”
order	int	nem	Rendelés azonosítója
orders	int[]	nem	Comma-separated IDs, up to 100

Válasz

{ "refill": 1932 }

Köteges válasz

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “refill_status”
refill	int	nem	Refill ID
refills	int[]	nem	Comma-separated IDs, up to 100

Válasz

{ "status": "Completed" }

Köteges válasz

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

action=cancel

Rendelés törlése

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

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “cancel”
order	int	nem	Rendelés azonosítója
orders	int[]	nem	Comma-separated IDs, up to 100

Válasz

{ "cancel": 1 }

Köteges válasz

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

action=balance

Egyenleg

Current account balance, in rubles.

Paraméter	Típus	Kötelező	Leírás
key	string	igen	API key from your dashboard, “API” tab
action	string	igen	The string “balance”

Válasz

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

Kódpéldák

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

Rendelés állapotok

A status metódus status mezője ezen értékek egyikét adja vissza.

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

Hibák

Az üzleti logikai hibák HTTP 200-as kóddal és egy error mezővel érkeznek. Csak a hitelesítés és a frekvencia limit HTTP státuszkódokkal válaszol.

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

Készen állsz a csatlakozásra?

Regisztrálj, töltsd fel az egyenlegedet, és bocsáss ki egy kulcsot az „API” fülön. Nincs külön jóváhagyási lépés.

Fiók létrehozása