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

Izstrādātājiem

API pārdevējiem un automatizācijai

Viens HTTP galapunkts nosež visu ciklu: iegūt katalogu, izveidot pasūtījumu, uzzināt statusu, pieprasīt Refill vai atcelšanu. Protokols sakrīt ar formātu, ko izmanto vairums SMM paneļu, tāpēc esošai integrācijai parasti pietiek mainīt URL un atslēgu.

Adrese

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

Tikai POST. Struktūru var sūtīt kā application/x-www-form-urlencoded vai kā application/json – abi formāti tiek pieņemti, atbilde vienmēr ir JSON.

Autorizācija

Atslēga tiek nodota pieprasījuma struktūrā laukā key. Mēs glabājam tikai tās SHA-256 hash, tāpēc atslēgu no datubāzes atjaunot nevar – ja tā nozaudēta, izveido jaunu. Atslēgu var atsaukt panelī jebkurā brīdī, tā pārstāj darboties nekavējoties.

Frekvences ierobežojums

60 pieprasījumi minūtē no vienas IP adreses. Pārsniedzot limitu, tiek atgriezts kods 429 un galvene Retry-After ar sekunžu skaitu līdz nākamajam mēģinājumam. Statusus labāk pieprasīt partijās caur orders, nevis viens pasūtījums vienā izsaukumā.

Metodes

action=services

Pakalpojumu saraksts

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “services”

Atbilde

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

action=add

Izveidot pasūtījumu

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “add”
service	int	jā	Service ID from the services method
link	string	jā	Link to the profile or post. The format is validated per platform and metric
quantity	int	jā	Quantity within the service min and max
runs	int	nē	Drip-feed: how many runs
interval	int	nē	Drip-feed: interval between runs, in minutes

Atbilde

{ "order": 84213 }

action=status

Pasūtījuma statuss

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “status”
order	int	nē	Pasūtījuma ID
orders	int[]	nē	Comma-separated IDs, up to 100

Atbilde

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

Atbilde partijai

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

Pieprasīt Refill

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “refill”
order	int	nē	Pasūtījuma ID
orders	int[]	nē	Comma-separated IDs, up to 100

Atbilde

{ "refill": 1932 }

Atbilde partijai

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “refill_status”
refill	int	nē	Refill ID
refills	int[]	nē	Comma-separated IDs, up to 100

Atbilde

{ "status": "Completed" }

Atbilde partijai

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

action=cancel

Atcelt pasūtījumu

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “cancel”
order	int	nē	Pasūtījuma ID
orders	int[]	nē	Comma-separated IDs, up to 100

Atbilde

{ "cancel": 1 }

Atbilde partijai

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

action=balance

Bilance

Current account balance, in rubles.

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “balance”

Atbilde

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

Koda piemēri

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

Pasūtījuma statusi

Status metodes status lauks atgriež vienu no šīm vērtībām.

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

Kļūdas

Biznesa loģikas kļūdas tiek atgrieztas ar HTTP 200 un error lauku. Tikai autorizācija un frekvences ierobežošana izmanto HTTP statusa kodus.

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

Gatavs savienoties?

Reģistrējies, papildini bilanci un izveido atslēgu cilnē «API». Atsevišķa saskaņojuma nav vajadzīgs.

Izveidot kontu

Izstrādātājiem

API pārdevējiem un automatizācijai

Adrese

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

Tikai POST. Struktūru var sūtīt kā application/x-www-form-urlencoded vai kā application/json – abi formāti tiek pieņemti, atbilde vienmēr ir JSON.

Autorizācija

Frekvences ierobežojums

Metodes

action=services

Pakalpojumu saraksts

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “services”

Atbilde

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

action=add

Izveidot pasūtījumu

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “add”
service	int	jā	Service ID from the services method
link	string	jā	Link to the profile or post. The format is validated per platform and metric
quantity	int	jā	Quantity within the service min and max
runs	int	nē	Drip-feed: how many runs
interval	int	nē	Drip-feed: interval between runs, in minutes

Atbilde

{ "order": 84213 }

action=status

Pasūtījuma statuss

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “status”
order	int	nē	Pasūtījuma ID
orders	int[]	nē	Comma-separated IDs, up to 100

Atbilde

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

Atbilde partijai

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

Pieprasīt Refill

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “refill”
order	int	nē	Pasūtījuma ID
orders	int[]	nē	Comma-separated IDs, up to 100

Atbilde

{ "refill": 1932 }

Atbilde partijai

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “refill_status”
refill	int	nē	Refill ID
refills	int[]	nē	Comma-separated IDs, up to 100

Atbilde

{ "status": "Completed" }

Atbilde partijai

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

action=cancel

Atcelt pasūtījumu

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

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “cancel”
order	int	nē	Pasūtījuma ID
orders	int[]	nē	Comma-separated IDs, up to 100

Atbilde

{ "cancel": 1 }

Atbilde partijai

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

action=balance

Bilance

Current account balance, in rubles.

Parametrs	Tips	Obligāts	Apraksts
key	string	jā	API key from your dashboard, “API” tab
action	string	jā	The string “balance”

Atbilde

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

Koda piemēri

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

Pasūtījuma statusi

Status metodes status lauks atgriež vienu no šīm vērtībām.

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

Kļūdas

Biznesa loģikas kļūdas tiek atgrieztas ar HTTP 200 un error lauku. Tikai autorizācija un frekvences ierobežošana izmanto HTTP statusa kodus.

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

Gatavs savienoties?

Reģistrējies, papildini bilanci un izveido atslēgu cilnē «API». Atsevišķa saskaņojuma nav vajadzīgs.

Izveidot kontu