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

Masu haɓaka

API don masu sayarwa da tsarin atomatik

Adreshin HTTP ɗaya yana rufe dukkan zagayowar: karanta katalogi, yin oda, duba matsayi, nema Refill ko soke. Tsarin yayi daidai da tsarin da yawancin SMM panel ke amfani da shi, don haka haɗin da ya dai yana buƙatar canza adreshi da maɓalli kawai.

Adiresi

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

POST kawai. Ana aika jiki a matsayin application/x-www-form-urlencoded ko application/json — ana karɓar duka tsarin biyu, amsa koyaushe JSON.

Tabbatuwa

Maɓalli ana watsawa a cikin jikin buƙata a matsayin filin key. Muna ajiye hash ɗin SHA-256 kawai, don haka ba za a iya dawo da maɓalli daga bayanan ba — idan ya ɓace, ƙirƙiri sabon. Za a iya kashe maɓalli a dashboard a kowane lokaci, yana daina aiki nan take.

Iyaka mita

Bukatu 60 a minti daga adreshin IP guda. Idan aka wuce, ana samun lambar 429 da taken Retry-After da daƙiƙa har zuwa ƙoƙari na gaba. Alhẽri a nẽma matsayi a cikin gungu ta hanyar orders, ba oda ɗaya a kowane kira ba.

Hanyoyi

action=services

Jerin sabisoshi

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “services”

Amsa

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

action=add

Ƙirƙiri oda

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “add”
service	int	i	Service ID from the services method
link	string	i	Link to the profile or post. The format is validated per platform and metric
quantity	int	i	Quantity within the service min and max
runs	int	a'a	Drip-feed: how many runs
interval	int	a'a	Drip-feed: interval between runs, in minutes

Amsa

{ "order": 84213 }

action=status

Matsayin oda

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “status”
order	int	a'a	Lambar oda
orders	int[]	a'a	Comma-separated IDs, up to 100

Amsa

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

Amsa don bargo

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

Nema Refill

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “refill”
order	int	a'a	Lambar oda
orders	int[]	a'a	Comma-separated IDs, up to 100

Amsa

{ "refill": 1932 }

Amsa don bargo

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “refill_status”
refill	int	a'a	Refill ID
refills	int[]	a'a	Comma-separated IDs, up to 100

Amsa

{ "status": "Completed" }

Amsa don bargo

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

action=cancel

Soke oda

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “cancel”
order	int	a'a	Lambar oda
orders	int[]	a'a	Comma-separated IDs, up to 100

Amsa

{ "cancel": 1 }

Amsa don bargo

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

action=balance

Daidaito

Current account balance, in rubles.

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “balance”

Amsa

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

Misalan lamba

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

Matsayin oda

Filin status na hanyar status yana mayar da ɗaya daga cikin waɗannan ƙimar.

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

Kurakurai

Kurakuran kasuwanci suna zuwa da lambar HTTP 200 da filin error. Tabbatuwa da iyaka mita kawai ke amsa da lambobin HTTP.

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

Shirye ku haɗa?

Yi rajista, kara daidaito kuma ƙirƙiri maɓalli akan shafin "API". Babu buƙatar amincewa ta daban.

Ƙirƙiri asusu

Masu haɓaka

API don masu sayarwa da tsarin atomatik

Adiresi

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

POST kawai. Ana aika jiki a matsayin application/x-www-form-urlencoded ko application/json — ana karɓar duka tsarin biyu, amsa koyaushe JSON.

Tabbatuwa

Iyaka mita

Hanyoyi

action=services

Jerin sabisoshi

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “services”

Amsa

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

action=add

Ƙirƙiri oda

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “add”
service	int	i	Service ID from the services method
link	string	i	Link to the profile or post. The format is validated per platform and metric
quantity	int	i	Quantity within the service min and max
runs	int	a'a	Drip-feed: how many runs
interval	int	a'a	Drip-feed: interval between runs, in minutes

Amsa

{ "order": 84213 }

action=status

Matsayin oda

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “status”
order	int	a'a	Lambar oda
orders	int[]	a'a	Comma-separated IDs, up to 100

Amsa

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

Amsa don bargo

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

Nema Refill

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “refill”
order	int	a'a	Lambar oda
orders	int[]	a'a	Comma-separated IDs, up to 100

Amsa

{ "refill": 1932 }

Amsa don bargo

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “refill_status”
refill	int	a'a	Refill ID
refills	int[]	a'a	Comma-separated IDs, up to 100

Amsa

{ "status": "Completed" }

Amsa don bargo

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

action=cancel

Soke oda

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

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “cancel”
order	int	a'a	Lambar oda
orders	int[]	a'a	Comma-separated IDs, up to 100

Amsa

{ "cancel": 1 }

Amsa don bargo

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

action=balance

Daidaito

Current account balance, in rubles.

Ma'auni	Nau'i	Ana buƙata	Kwatanta
key	string	i	API key from your dashboard, “API” tab
action	string	i	The string “balance”

Amsa

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

Misalan lamba

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

Matsayin oda

Filin status na hanyar status yana mayar da ɗaya daga cikin waɗannan ƙimar.

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

Kurakurai

Kurakuran kasuwanci suna zuwa da lambar HTTP 200 da filin error. Tabbatuwa da iyaka mita kawai ke amsa da lambobin HTTP.

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

Shirye ku haɗa?

Yi rajista, kara daidaito kuma ƙirƙiri maɓalli akan shafin "API". Babu buƙatar amincewa ta daban.

Ƙirƙiri asusu