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

Kwa watengenezaji

API kwa wauzaji upya na otomatiki

Anwani moja ya HTTP inashughulikia mzunguko wote: soma orodha, weka agizo, angalia hali, omba Refill au katizo. Itifaki inalingana na muundo unaotumia paneli nyingi za SMM, hivyo muunganisho uliopo kwa kawaida unahitaji tu kubadilisha anwani na funguo.

Anwani

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

POST tu. Tuma ama application/x-www-form-urlencoded ama application/json — zote zinakubaliwa, na jibu kila wakati ni JSON.

Uthibitisho

Funguo hutumwa kwenye mwili wa ombi kwa uga wa key. Tunahifadhi hash yake ya SHA-256 tu, hivyo funguo haiwezi kurudishwa kutoka hifadhidata — ikiwa imepotea, toa mpya. Funguo inaweza kurudishwa nyuma kutoka dashibodi wakati wowote na haifanyi kazi mara moja.

Kikomo cha marudio

Maombi 60 kwa dakika kutoka anwani moja ya IP. Ikiwa imezidi, kificho 429 kinakuja na kichwa cha Retry-After chenye idadi ya sekunde hadi jaribio linalofuata. Hali ni bora kuomba kwa vikundi kupitia orders, kuliko omba agizo moja kwa kila wito.

Njia

action=services

Orodha ya huduma

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “services”

Jibu

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

action=add

Unda agizo

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “add”
service	int	ndio	Service ID from the services method
link	string	ndio	Link to the profile or post. The format is validated per platform and metric
quantity	int	ndio	Quantity within the service min and max
runs	int	hapana	Drip-feed: how many runs
interval	int	hapana	Drip-feed: interval between runs, in minutes

Jibu

{ "order": 84213 }

action=status

Hali ya agizo

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “status”
order	int	hapana	Kitambulisho cha agizo
orders	int[]	hapana	Comma-separated IDs, up to 100

Jibu

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

Jibu la kifurushi

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

Omba Refill

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “refill”
order	int	hapana	Kitambulisho cha agizo
orders	int[]	hapana	Comma-separated IDs, up to 100

Jibu

{ "refill": 1932 }

Jibu la kifurushi

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “refill_status”
refill	int	hapana	Refill ID
refills	int[]	hapana	Comma-separated IDs, up to 100

Jibu

{ "status": "Completed" }

Jibu la kifurushi

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

action=cancel

Katiza agizo

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “cancel”
order	int	hapana	Kitambulisho cha agizo
orders	int[]	hapana	Comma-separated IDs, up to 100

Jibu

{ "cancel": 1 }

Jibu la kifurushi

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

action=balance

Salio

Current account balance, in rubles.

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “balance”

Jibu

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

Mifano ya msimbo

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

Hali za agizo

Uga wa status wa njia ya status hurudisha moja ya thamani hizi.

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

Makosa

Makosa ya mantiki ya biashara huja na kificho 200 na uga wa error. Namba za HTTP zinatumiwa tu na uthibitisho na kikomo cha marudio.

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

Tayari kuunganishwa?

Jisajili, jaza salio na toa funguo kwenye kichupo cha «API». Hakuna idhini ya pekee inayohitajika.

Unda akaunti

Kwa watengenezaji

API kwa wauzaji upya na otomatiki

Anwani

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

POST tu. Tuma ama application/x-www-form-urlencoded ama application/json — zote zinakubaliwa, na jibu kila wakati ni JSON.

Uthibitisho

Kikomo cha marudio

Njia

action=services

Orodha ya huduma

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “services”

Jibu

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

action=add

Unda agizo

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “add”
service	int	ndio	Service ID from the services method
link	string	ndio	Link to the profile or post. The format is validated per platform and metric
quantity	int	ndio	Quantity within the service min and max
runs	int	hapana	Drip-feed: how many runs
interval	int	hapana	Drip-feed: interval between runs, in minutes

Jibu

{ "order": 84213 }

action=status

Hali ya agizo

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “status”
order	int	hapana	Kitambulisho cha agizo
orders	int[]	hapana	Comma-separated IDs, up to 100

Jibu

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

Jibu la kifurushi

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

Omba Refill

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “refill”
order	int	hapana	Kitambulisho cha agizo
orders	int[]	hapana	Comma-separated IDs, up to 100

Jibu

{ "refill": 1932 }

Jibu la kifurushi

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “refill_status”
refill	int	hapana	Refill ID
refills	int[]	hapana	Comma-separated IDs, up to 100

Jibu

{ "status": "Completed" }

Jibu la kifurushi

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

action=cancel

Katiza agizo

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

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “cancel”
order	int	hapana	Kitambulisho cha agizo
orders	int[]	hapana	Comma-separated IDs, up to 100

Jibu

{ "cancel": 1 }

Jibu la kifurushi

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

action=balance

Salio

Current account balance, in rubles.

Kigezo	Aina	Lazima	Maelezo
key	string	ndio	API key from your dashboard, “API” tab
action	string	ndio	The string “balance”

Jibu

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

Mifano ya msimbo

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

Hali za agizo

Uga wa status wa njia ya status hurudisha moja ya thamani hizi.

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

Makosa

Makosa ya mantiki ya biashara huja na kificho 200 na uga wa error. Namba za HTTP zinatumiwa tu na uthibitisho na kikomo cha marudio.

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

Tayari kuunganishwa?

Jisajili, jaza salio na toa funguo kwenye kichupo cha «API». Hakuna idhini ya pekee inayohitajika.

Unda akaunti