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

Arendajatele

API vahendajatele ja automatiseerimisele

Üks HTTP-aadress katab kogu töövoog: loe kataloogi, esita tellimused, päri nende staatust, taotle Refill või tühistamist. Protokoll ühtib enamiku SMM-paneelide vorminguga, seega olemasolevale integratsioonile piisab tavaliselt ainult aadressi ja võtme vahetamisest.

Aadress

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

Ainult POST. Päist saab saata kui application/x-www-form-urlencoded või kui application/json – mõlemad vormingud on aktsepteeritud, vastus on alati JSON.

Autoriseerimine

Võti edastatakse päringu kehas väljaga key. Meie süsteemis talletatakse ainult selle SHA-256-räsi, seega võtit andmebaasist taastada ei saa – kui see on kadunud, väljasta uus. Võtit saab töölaual igal ajal välja lülitada, see lakkab kohe töötamast.

Sageduse piirang

60 päringut minutis ühelt IP-aadressilt. Ülempiiri ületamisel saadakse kood 429 ja päis Retry-After järgmise katse sekundite arvuga. Staatusi on parem pärida partiides orders kaudu, mitte üks tellimus korra kohta.

Meetodid

action=services

Teenuste loend

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “services”

Vastus

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

action=add

Loo tellimus

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “add”
service	int	jah	Service ID from the services method
link	string	jah	Link to the profile or post. The format is validated per platform and metric
quantity	int	jah	Quantity within the service min and max
runs	int	ei	Drip-feed: how many runs
interval	int	ei	Drip-feed: interval between runs, in minutes

Vastus

{ "order": 84213 }

action=status

Tellimuse staatus

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “status”
order	int	ei	Tellimuse number
orders	int[]	ei	Comma-separated IDs, up to 100

Vastus

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

Partii vastus

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

Taotle Refill

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “refill”
order	int	ei	Tellimuse number
orders	int[]	ei	Comma-separated IDs, up to 100

Vastus

{ "refill": 1932 }

Partii vastus

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “refill_status”
refill	int	ei	Refill ID
refills	int[]	ei	Comma-separated IDs, up to 100

Vastus

{ "status": "Completed" }

Partii vastus

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

action=cancel

Tühista tellimus

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “cancel”
order	int	ei	Tellimuse number
orders	int[]	ei	Comma-separated IDs, up to 100

Vastus

{ "cancel": 1 }

Partii vastus

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

action=balance

Saldo

Current account balance, in rubles.

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “balance”

Vastus

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

Koodinäited

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

Tellimuse staatused

Meetodi status välja status annab vastuseks ühe neist väärtustest.

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

Vead

Ärigooga seotud vead tulevad koos koodiga 200 ja väljaga error. HTTP-koode kasutavad ainult autoriseerimine ja sageduse piirang.

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

Valmis ühenduma?

Loo konto, lae saldot ja väljasta võti vahekaardil «API». Eraldi kinnitust pole vaja.

Loo konto

Arendajatele

API vahendajatele ja automatiseerimisele

Aadress

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

Ainult POST. Päist saab saata kui application/x-www-form-urlencoded või kui application/json – mõlemad vormingud on aktsepteeritud, vastus on alati JSON.

Autoriseerimine

Sageduse piirang

Meetodid

action=services

Teenuste loend

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “services”

Vastus

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

action=add

Loo tellimus

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “add”
service	int	jah	Service ID from the services method
link	string	jah	Link to the profile or post. The format is validated per platform and metric
quantity	int	jah	Quantity within the service min and max
runs	int	ei	Drip-feed: how many runs
interval	int	ei	Drip-feed: interval between runs, in minutes

Vastus

{ "order": 84213 }

action=status

Tellimuse staatus

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “status”
order	int	ei	Tellimuse number
orders	int[]	ei	Comma-separated IDs, up to 100

Vastus

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

Partii vastus

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

Taotle Refill

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “refill”
order	int	ei	Tellimuse number
orders	int[]	ei	Comma-separated IDs, up to 100

Vastus

{ "refill": 1932 }

Partii vastus

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “refill_status”
refill	int	ei	Refill ID
refills	int[]	ei	Comma-separated IDs, up to 100

Vastus

{ "status": "Completed" }

Partii vastus

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

action=cancel

Tühista tellimus

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

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “cancel”
order	int	ei	Tellimuse number
orders	int[]	ei	Comma-separated IDs, up to 100

Vastus

{ "cancel": 1 }

Partii vastus

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

action=balance

Saldo

Current account balance, in rubles.

Parameeter	Tüüp	Kohustuslik	Kirjeldus
key	string	jah	API key from your dashboard, “API” tab
action	string	jah	The string “balance”

Vastus

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

Koodinäited

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

Tellimuse staatused

Meetodi status välja status annab vastuseks ühe neist väärtustest.

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

Vead

Ärigooga seotud vead tulevad koos koodiga 200 ja väljaga error. HTTP-koode kasutavad ainult autoriseerimine ja sageduse piirang.

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

Valmis ühenduma?

Loo konto, lae saldot ja väljasta võti vahekaardil «API». Eraldi kinnitust pole vaja.

Loo konto