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

Für Entwickler

API für Reseller und Automatisierung

Eine HTTP-Adresse deckt den gesamten Ablauf ab: Katalog abrufen, Bestellung anlegen, Status prüfen, Refill oder Stornierung anfordern. Das Protokoll entspricht dem Format der meisten SMM-Panels — einer bestehenden Integration genügen meist neue Adresse und neuer Schlüssel.

Adresse

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

Nur POST. Der Body kann als application/x-www-form-urlencoded oder als application/json gesendet werden — beides wird akzeptiert, die Antwort ist immer JSON.

Authentifizierung

Der Schlüssel wird im Feld key des Request-Bodys übertragen. Wir speichern nur seinen SHA-256-Hash, aus der Datenbank lässt er sich also nicht wiederherstellen — bei Verlust erstellen Sie einen neuen. Ein Schlüssel kann jederzeit im Konto deaktiviert werden und wirkt sofort nicht mehr.

Ratenbegrenzung

60 Anfragen pro Minute von einer IP-Adresse. Darüber antwortet der Endpunkt mit 429 und einem Retry-After-Header mit der Wartezeit in Sekunden. Fragen Sie Status besser gebündelt über orders ab statt einzeln.

Methoden

action=services

Leistungsliste

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

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “services”

Antwort

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

action=add

Bestellung erstellen

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

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

Antwort

{ "order": 84213 }

action=status

Bestellstatus

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

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “status”
order	int	nein	Bestellnummer
orders	int[]	nein	Comma-separated IDs, up to 100

Antwort

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

Antwort für ein Bündel

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

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

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill”
order	int	nein	Bestellnummer
orders	int[]	nein	Comma-separated IDs, up to 100

Antwort

{ "refill": 1932 }

Antwort für ein Bündel

[
  { "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	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill_status”
refill	int	nein	Refill ID
refills	int[]	nein	Comma-separated IDs, up to 100

Antwort

{ "status": "Completed" }

Antwort für ein Bündel

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

action=cancel

Bestellung stornieren

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

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “cancel”
order	int	nein	Bestellnummer
orders	int[]	nein	Comma-separated IDs, up to 100

Antwort

{ "cancel": 1 }

Antwort für ein Bündel

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

action=balance

Guthaben

Current account balance, in rubles.

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “balance”

Antwort

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

Codebeispiele

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

Bestellstatus

Das Feld status der Methode status liefert einen dieser Werte.

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

Fehler

Fachliche Fehler kommen mit Code 200 und einem error-Feld. Nur Authentifizierung und Ratenbegrenzung antworten mit HTTP-Statuscodes.

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

Bereit für die Anbindung?

Registrieren Sie sich, laden Sie Guthaben auf und erstellen Sie einen Schlüssel im Tab „API“. Eine gesonderte Freigabe ist nicht nötig.

Konto erstellen

Für Entwickler

API für Reseller und Automatisierung

Adresse

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

Nur POST. Der Body kann als application/x-www-form-urlencoded oder als application/json gesendet werden — beides wird akzeptiert, die Antwort ist immer JSON.

Authentifizierung

Ratenbegrenzung

Methoden

action=services

Leistungsliste

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

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “services”

Antwort

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

action=add

Bestellung erstellen

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

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

Antwort

{ "order": 84213 }

action=status

Bestellstatus

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

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “status”
order	int	nein	Bestellnummer
orders	int[]	nein	Comma-separated IDs, up to 100

Antwort

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

Antwort für ein Bündel

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

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

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill”
order	int	nein	Bestellnummer
orders	int[]	nein	Comma-separated IDs, up to 100

Antwort

{ "refill": 1932 }

Antwort für ein Bündel

[
  { "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	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill_status”
refill	int	nein	Refill ID
refills	int[]	nein	Comma-separated IDs, up to 100

Antwort

{ "status": "Completed" }

Antwort für ein Bündel

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

action=cancel

Bestellung stornieren

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

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “cancel”
order	int	nein	Bestellnummer
orders	int[]	nein	Comma-separated IDs, up to 100

Antwort

{ "cancel": 1 }

Antwort für ein Bündel

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

action=balance

Guthaben

Current account balance, in rubles.

Parameter	Typ	Pflicht	Beschreibung
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “balance”

Antwort

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

Codebeispiele

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

Bestellstatus

Das Feld status der Methode status liefert einen dieser Werte.

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

Fehler

Fachliche Fehler kommen mit Code 200 und einem error-Feld. Nur Authentifizierung und Ratenbegrenzung antworten mit HTTP-Statuscodes.

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

Bereit für die Anbindung?

Registrieren Sie sich, laden Sie Guthaben auf und erstellen Sie einen Schlüssel im Tab „API“. Eine gesonderte Freigabe ist nicht nötig.

Konto erstellen