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

Àwọn oníṣẹ́-dárílẹ̀

API fún àwọn oní-tà-ún-tà àti ìmúṣẹ àlọ́dọ́tún

Àdírẹ́sì HTTP kan ń bò ohun gbogbo: gba kátálọ̀gì, dá àṣẹ, mọ̀ ipò, béèrè àfikún tàbí ìfàgile. Àdájọ́ náà bá fíyọ ìdàrílẹ̀ tó ń lo ọ̀pọ̀lọpọ̀ àwọn páńẹ̀lì SMM, ìyíwọ́ tó ti ready máa ń wà nílò yíyí àdírẹ́sì àti kóòdù padà nìkan.

Àdírẹ́sì

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

POST nìkan. Ẹ le fi àyè ránṣẹ́ gẹ́gẹ́bí application/x-www-form-urlencoded tàbí application/json — a ń gba àpapọ̀ méjèèjì, idáhùn ń jẹ́ JSON lójúpúpọ̀.

Ìjẹ́rìí

Kóòdù ń lọ nínú àyà ìbéèrè gẹ́gẹ́bí ọ̀rọ̀ key. A ń fi SHA-256 hash rẹ̀ pamọ́ nìkan, ìyọ́ ni a kò le dá kóòdù padà láti inú àdámọ́ — tí ó bá sọnu, ẹ dá tuntun. Ẹ le pa kóòdù nínú dashboard ní àkókò tó bá wù yín, ó ń ṣiṣẹ́ lásìkò yẹn.

Àlà ìwákùkù

Àwọn ìbéèrè 60 lórí ìṣẹ́jú láti àdírẹ́sì IP kan. Tí ó bá ju, kóòdù 429 àti ìpòsóhùn Retry-After ń wá pẹ̀lú nọ́ṣà àwọn ìṣẹ́jú títí ìgbà tòókù. Ìwà yára láti béèrè àwọn ipò nínú ọ̀pọ̀lọpọ̀ pẹ̀lú orders, kì í ṣe fún àṣẹ kan lórí ìpè.

Àwọn ọ̀nà

action=services

Àtójọ àwọn iṣẹ́

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “services”

Idáhùn

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

action=add

Dá àṣẹ

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “add”
service	int	bẹ́ẹ̀ni	Service ID from the services method
link	string	bẹ́ẹ̀ni	Link to the profile or post. The format is validated per platform and metric
quantity	int	bẹ́ẹ̀ni	Quantity within the service min and max
runs	int	bẹ́ẹ̀kọ́	Drip-feed: how many runs
interval	int	bẹ́ẹ̀kọ́	Drip-feed: interval between runs, in minutes

Idáhùn

{ "order": 84213 }

action=status

Ipò àṣẹ

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “status”
order	int	bẹ́ẹ̀kọ́	Nọ́ṣà àṣẹ
orders	int[]	bẹ́ẹ̀kọ́	Comma-separated IDs, up to 100

Idáhùn

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

Idáhùn fún ọ̀pọ̀lọpọ̀

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

Béèrè fún àfikún

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “refill”
order	int	bẹ́ẹ̀kọ́	Nọ́ṣà àṣẹ
orders	int[]	bẹ́ẹ̀kọ́	Comma-separated IDs, up to 100

Idáhùn

{ "refill": 1932 }

Idáhùn fún ọ̀pọ̀lọpọ̀

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “refill_status”
refill	int	bẹ́ẹ̀kọ́	Refill ID
refills	int[]	bẹ́ẹ̀kọ́	Comma-separated IDs, up to 100

Idáhùn

{ "status": "Completed" }

Idáhùn fún ọ̀pọ̀lọpọ̀

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

action=cancel

Fàgile àṣẹ

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “cancel”
order	int	bẹ́ẹ̀kọ́	Nọ́ṣà àṣẹ
orders	int[]	bẹ́ẹ̀kọ́	Comma-separated IDs, up to 100

Idáhùn

{ "cancel": 1 }

Idáhùn fún ọ̀pọ̀lọpọ̀

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

action=balance

Balansi

Current account balance, in rubles.

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “balance”

Idáhùn

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

Àwọn àpẹ̀rẹ̀ kóòdù

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

Àwọn ipò àṣẹ

Ọ̀rọ̀ status nínú ọ̀nà status ń dá aǹkan kan láti nínú àwọn iye wọ̀nyí padà.

pending: Accepted by the panel, not yet sent to the provider
in_progress: ń ṣiṣẹ́
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

Àwọn àṣìṣe

Àwọn àṣìṣe ìdàsílẹ̀-iṣẹ́ ń wá pẹ̀lú kóòdù 200 àti ọ̀rọ̀ error. Àdírẹ́sì HTTP nìkan l'á ń dá pẹ̀lú ìjẹ́rìí àti àlà ìwákùkù.

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

Ẹ setán láti wọ?

Ẹ forúkọ́sílẹ̀, ẹ fi kún balansi àti ẹ jáde kóòdù lórí tábì «API». Kò sí ìfọwọ́sọ́wọ́ kẹ̀kẹ̀.

Dá àkọ́ọ̀lì

Àwọn oníṣẹ́-dárílẹ̀

API fún àwọn oní-tà-ún-tà àti ìmúṣẹ àlọ́dọ́tún

Àdírẹ́sì

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

POST nìkan. Ẹ le fi àyè ránṣẹ́ gẹ́gẹ́bí application/x-www-form-urlencoded tàbí application/json — a ń gba àpapọ̀ méjèèjì, idáhùn ń jẹ́ JSON lójúpúpọ̀.

Ìjẹ́rìí

Àlà ìwákùkù

Àwọn ọ̀nà

action=services

Àtójọ àwọn iṣẹ́

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “services”

Idáhùn

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

action=add

Dá àṣẹ

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “add”
service	int	bẹ́ẹ̀ni	Service ID from the services method
link	string	bẹ́ẹ̀ni	Link to the profile or post. The format is validated per platform and metric
quantity	int	bẹ́ẹ̀ni	Quantity within the service min and max
runs	int	bẹ́ẹ̀kọ́	Drip-feed: how many runs
interval	int	bẹ́ẹ̀kọ́	Drip-feed: interval between runs, in minutes

Idáhùn

{ "order": 84213 }

action=status

Ipò àṣẹ

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “status”
order	int	bẹ́ẹ̀kọ́	Nọ́ṣà àṣẹ
orders	int[]	bẹ́ẹ̀kọ́	Comma-separated IDs, up to 100

Idáhùn

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

Idáhùn fún ọ̀pọ̀lọpọ̀

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

Béèrè fún àfikún

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “refill”
order	int	bẹ́ẹ̀kọ́	Nọ́ṣà àṣẹ
orders	int[]	bẹ́ẹ̀kọ́	Comma-separated IDs, up to 100

Idáhùn

{ "refill": 1932 }

Idáhùn fún ọ̀pọ̀lọpọ̀

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “refill_status”
refill	int	bẹ́ẹ̀kọ́	Refill ID
refills	int[]	bẹ́ẹ̀kọ́	Comma-separated IDs, up to 100

Idáhùn

{ "status": "Completed" }

Idáhùn fún ọ̀pọ̀lọpọ̀

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

action=cancel

Fàgile àṣẹ

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

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “cancel”
order	int	bẹ́ẹ̀kọ́	Nọ́ṣà àṣẹ
orders	int[]	bẹ́ẹ̀kọ́	Comma-separated IDs, up to 100

Idáhùn

{ "cancel": 1 }

Idáhùn fún ọ̀pọ̀lọpọ̀

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

action=balance

Balansi

Current account balance, in rubles.

Ìyípayá	Irú	A nílọ	Àpèjúwe
key	string	bẹ́ẹ̀ni	API key from your dashboard, “API” tab
action	string	bẹ́ẹ̀ni	The string “balance”

Idáhùn

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

Àwọn àpẹ̀rẹ̀ kóòdù

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

Àwọn ipò àṣẹ

Ọ̀rọ̀ status nínú ọ̀nà status ń dá aǹkan kan láti nínú àwọn iye wọ̀nyí padà.

pending: Accepted by the panel, not yet sent to the provider
in_progress: ń ṣiṣẹ́
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

Àwọn àṣìṣe

Àwọn àṣìṣe ìdàsílẹ̀-iṣẹ́ ń wá pẹ̀lú kóòdù 200 àti ọ̀rọ̀ error. Àdírẹ́sì HTTP nìkan l'á ń dá pẹ̀lú ìjẹ́rìí àti àlà ìwákùkù.

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

Ẹ setán láti wọ?

Ẹ forúkọ́sílẹ̀, ẹ fi kún balansi àti ẹ jáde kóòdù lórí tábì «API». Kò sí ìfọwọ́sọ́wọ́ kẹ̀kẹ̀.

Dá àkọ́ọ̀lì