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

Ontwikkelaars

API vir herverskaffers en outomatisering

Een HTTP-eindpunt dek die hele werkvloei: lees die katalogus, plaas bestellings, pols hul status, vra Refills en kansellasies aan. Die protokol pas by die formaat wat die meeste SMM-panele gebruik, so 'n bestaande integrasie benodig gewoonlik net 'n nuwe URL en sleutel.

Adres

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

Slegs POST. Stuur of application/x-www-form-urlencoded of application/json — albei formate word aanvaar, en antwoorde is altyd JSON.

Magtiging

Die sleutel reis in die versoekliggaam as die key-veld. Ons stoor slegs sy SHA-256-hash, so 'n sleutel kan nie uit ons databasis herwin word nie — as jy dit verloor, reik 'n nuwe een uit. 'n Sleutel kan enige tyd uit die dashboard teruggetrek word en hou dadelik op werk.

Tempo-limiet

60 versoeke per minuut vanaf een IP-adres. Bo dit antwoord die eindpunt 429 en sluit 'n Retry-After-kop in wat jou vertel hoeveel sekondes om te wag. Pols statusse in bondels via orders eerder as een oproep per bestelling.

Metodes

action=services

Dienslys

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

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “services”

Antwoord

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

action=add

Skep bestelling

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

Parameter	Tipe	Vereis	Beskrywing
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	nee	Drip-feed: how many runs
interval	int	nee	Drip-feed: interval between runs, in minutes

Antwoord

{ "order": 84213 }

action=status

Bestellingsstatus

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

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “status”
order	int	nee	Bestelling-ID
orders	int[]	nee	Comma-separated IDs, up to 100

Antwoord

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

Bondel-antwoord

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

Vra Refill aan

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

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill”
order	int	nee	Bestelling-ID
orders	int[]	nee	Comma-separated IDs, up to 100

Antwoord

{ "refill": 1932 }

Bondel-antwoord

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

Antwoord

{ "status": "Completed" }

Bondel-antwoord

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

action=cancel

Kanselleer bestelling

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

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “cancel”
order	int	nee	Bestelling-ID
orders	int[]	nee	Comma-separated IDs, up to 100

Antwoord

{ "cancel": 1 }

Bondel-antwoord

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

action=balance

Saldo

Current account balance, in rubles.

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “balance”

Antwoord

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

Kodevoorbeelde

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

Bestellingsstatusse

Die status-veld van die status-metode gee een van hierdie waardes terug.

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

Foute

Besigheidsfoute kom terug met HTTP 200 en 'n error-veld. Slegs magtiging en tempo-limitering gebruik HTTP-statuskodes.

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

Klaar om te koppel?

Skep 'n rekening, laai jou saldo op en reik 'n sleutel uit op die API-oortjie. Daar is geen afsonderlike goedkeuringsstap nie.

Skep 'n rekening

Ontwikkelaars

API vir herverskaffers en outomatisering

Adres

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

Slegs POST. Stuur of application/x-www-form-urlencoded of application/json — albei formate word aanvaar, en antwoorde is altyd JSON.

Magtiging

Tempo-limiet

Metodes

action=services

Dienslys

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

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “services”

Antwoord

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

action=add

Skep bestelling

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

Parameter	Tipe	Vereis	Beskrywing
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	nee	Drip-feed: how many runs
interval	int	nee	Drip-feed: interval between runs, in minutes

Antwoord

{ "order": 84213 }

action=status

Bestellingsstatus

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

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “status”
order	int	nee	Bestelling-ID
orders	int[]	nee	Comma-separated IDs, up to 100

Antwoord

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

Bondel-antwoord

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

Vra Refill aan

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

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill”
order	int	nee	Bestelling-ID
orders	int[]	nee	Comma-separated IDs, up to 100

Antwoord

{ "refill": 1932 }

Bondel-antwoord

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

Antwoord

{ "status": "Completed" }

Bondel-antwoord

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

action=cancel

Kanselleer bestelling

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

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “cancel”
order	int	nee	Bestelling-ID
orders	int[]	nee	Comma-separated IDs, up to 100

Antwoord

{ "cancel": 1 }

Bondel-antwoord

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

action=balance

Saldo

Current account balance, in rubles.

Parameter	Tipe	Vereis	Beskrywing
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “balance”

Antwoord

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

Kodevoorbeelde

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

Bestellingsstatusse

Die status-veld van die status-metode gee een van hierdie waardes terug.

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

Foute

Besigheidsfoute kom terug met HTTP 200 en 'n error-veld. Slegs magtiging en tempo-limitering gebruik HTTP-statuskodes.

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

Klaar om te koppel?

Skep 'n rekening, laai jou saldo op en reik 'n sleutel uit op die API-oortjie. Daar is geen afsonderlike goedkeuringsstap nie.

Skep 'n rekening