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

Kehittäjille

API jälleenmyyjille ja automaatiolle

Yksi HTTP-päätepiste kattaa koko työnkulun: lue luettelo, luo tilauksia, kysy tilaa, pyydä Refill tai peruutus. Protokola vastaa muotoa, jota useimmat SMM-paneelit käyttävät, joten olemassa oleva integraatio tarvitsee yleensä vain uuden URL-osoitteen ja avaimen.

Osoite

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

Vain POST. rungon voi lähettää joko application/x-www-form-urlencoded- tai application/json-muodossa – molemmat hyväksytään, vastaus on aina JSON.

Tunnistautuminen

Avain kulkee pyynnön rungossa kentänä key. Säilytämme vain sen SHA-256-tiivisteen, joten avainta ei voi palauttaa tietokannastamme – jos kadotat sen, luo uusi. Avain voidaan kumota hallintapaneelista milloin tahansa ja se lakkaa toimimasta heti.

Taajuusrajoitus

60 pyyntöä minuutissa yhdestä IP-osoitteesta. Ylityksen jälkeen vastataan koodilla 429 ja otsikolla Retry-After, joka kertoo seuraavaan yritykseen odotettavat sekunnit. Kysy tilat mieluummin erissä orders-metodin kautta kuin yksitellen per tilaus.

Metodit

action=services

Palveluluettelo

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “services”

Vastaus

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

action=add

Luo tilaus

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “add”
service	int	kyllä	Service ID from the services method
link	string	kyllä	Link to the profile or post. The format is validated per platform and metric
quantity	int	kyllä	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

Vastaus

{ "order": 84213 }

action=status

Tilauksen tila

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “status”
order	int	ei	Tilausnumero
orders	int[]	ei	Comma-separated IDs, up to 100

Vastaus

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

Erävastaus

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

Pyydä Refill

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “refill”
order	int	ei	Tilausnumero
orders	int[]	ei	Comma-separated IDs, up to 100

Vastaus

{ "refill": 1932 }

Erävastaus

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “refill_status”
refill	int	ei	Refill ID
refills	int[]	ei	Comma-separated IDs, up to 100

Vastaus

{ "status": "Completed" }

Erävastaus

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

action=cancel

Peruuta tilaus

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “cancel”
order	int	ei	Tilausnumero
orders	int[]	ei	Comma-separated IDs, up to 100

Vastaus

{ "cancel": 1 }

Erävastaus

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

action=balance

Saldo

Current account balance, in rubles.

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “balance”

Vastaus

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

Koodiesimerkit

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

Tilausten tilat

Status-metodin status-kenttä palauttaa yhden näistä arvoista.

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

Virheet

Liiketoimintalogiikan virheet palautetaan HTTP:lla 200 ja error-kentällä. HTTP-tilakoodeja käyttävät vain tunnistautuminen ja taajuusrajoitus.

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

Valmiita yhdistämään?

Luo tili, lataa saldoa ja luo avain »API«-välilehdellä. Erillistä hyväksymistä ei tarvita.

Luo tili

Kehittäjille

API jälleenmyyjille ja automaatiolle

Osoite

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

Vain POST. rungon voi lähettää joko application/x-www-form-urlencoded- tai application/json-muodossa – molemmat hyväksytään, vastaus on aina JSON.

Tunnistautuminen

Taajuusrajoitus

Metodit

action=services

Palveluluettelo

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “services”

Vastaus

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

action=add

Luo tilaus

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “add”
service	int	kyllä	Service ID from the services method
link	string	kyllä	Link to the profile or post. The format is validated per platform and metric
quantity	int	kyllä	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

Vastaus

{ "order": 84213 }

action=status

Tilauksen tila

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “status”
order	int	ei	Tilausnumero
orders	int[]	ei	Comma-separated IDs, up to 100

Vastaus

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

Erävastaus

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

Pyydä Refill

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “refill”
order	int	ei	Tilausnumero
orders	int[]	ei	Comma-separated IDs, up to 100

Vastaus

{ "refill": 1932 }

Erävastaus

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “refill_status”
refill	int	ei	Refill ID
refills	int[]	ei	Comma-separated IDs, up to 100

Vastaus

{ "status": "Completed" }

Erävastaus

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

action=cancel

Peruuta tilaus

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

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “cancel”
order	int	ei	Tilausnumero
orders	int[]	ei	Comma-separated IDs, up to 100

Vastaus

{ "cancel": 1 }

Erävastaus

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

action=balance

Saldo

Current account balance, in rubles.

Parametri	Tyyppi	Pakollinen	Kuvaus
key	string	kyllä	API key from your dashboard, “API” tab
action	string	kyllä	The string “balance”

Vastaus

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

Koodiesimerkit

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

Tilausten tilat

Status-metodin status-kenttä palauttaa yhden näistä arvoista.

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

Virheet

Liiketoimintalogiikan virheet palautetaan HTTP:lla 200 ja error-kentällä. HTTP-tilakoodeja käyttävät vain tunnistautuminen ja taajuusrajoitus.

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

Valmiita yhdistämään?

Luo tili, lataa saldoa ja luo avain »API«-välilehdellä. Erillistä hyväksymistä ei tarvita.

Luo tili