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

Para sa mga developer

API para sa mga reseller at automation

Isang HTTP endpoint ang sumasaklaw sa buong workflow: basahin ang katalogo, mag-place ng order, suriin ang status, at humiling ng refill o pagkansela. Tugma ang protocol sa format na ginagamit ng karamihan sa SMM panel, kaya ang existing na integration ay madalas nangangailangan lang ng bagong URL at key.

Address

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

POST lang. Maaaring ipadala bilang application/x-www-form-urlencoded o application/json — tinatanggap ang parehong format, at palaging JSON ang sagot.

Authentication

Napupunta ang key sa request body bilang key field. Tanging SHA-256 hash nito lamang ang naka-save namin, kaya hindi mababawi ang key mula sa database namin — kapag nawala, bumuo ng bago. Maaaring bawiin ang key mula sa dashboard anumang oras at titigil agad ito sa paggana.

Rate limit

60 request kada minuto mula sa isang IP address. Kapag lumampas, nagbibigay ng code 429 ang endpoint at kasama ang Retry-After header na nagsasabi kung ilang segundo maghihintay. Hilingin ang status nang maramihan sa pamamagitan ng orders sa halip na isang tawag kada order.

Mga method

action=services

Listahan ng serbisyo

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “services”

Sagot

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

action=add

Gumawa ng order

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

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

Sagot

{ "order": 84213 }

action=status

Status ng order

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “status”
order	int	hindi	Order ID
orders	int[]	hindi	Comma-separated IDs, up to 100

Sagot

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

Sagot para sa batch

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

Humiling ng refill

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “refill”
order	int	hindi	Order ID
orders	int[]	hindi	Comma-separated IDs, up to 100

Sagot

{ "refill": 1932 }

Sagot para sa batch

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “refill_status”
refill	int	hindi	Refill ID
refills	int[]	hindi	Comma-separated IDs, up to 100

Sagot

{ "status": "Completed" }

Sagot para sa batch

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

action=cancel

Kanselahin ang order

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “cancel”
order	int	hindi	Order ID
orders	int[]	hindi	Comma-separated IDs, up to 100

Sagot

{ "cancel": 1 }

Sagot para sa batch

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

action=balance

Balanse

Current account balance, in rubles.

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “balance”

Sagot

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

Mga halimbawa ng code

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

Mga status ng order

Nagbabalik ang status field ng status method ng isa sa mga value na ito.

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

Mga error

Bumabalik ang mga business error na may HTTP 200 at error field. Tanging authentication at rate limiting lang ang gumagamit ng HTTP status code.

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

Handa nang magkonekta?

Gumawa ng account, mag-top up ng balanse at bumuo ng key sa API tab. Walang hiwalay na approval step.

Gumawa ng account

Para sa mga developer

API para sa mga reseller at automation

Address

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

POST lang. Maaaring ipadala bilang application/x-www-form-urlencoded o application/json — tinatanggap ang parehong format, at palaging JSON ang sagot.

Authentication

Rate limit

Mga method

action=services

Listahan ng serbisyo

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “services”

Sagot

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

action=add

Gumawa ng order

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

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

Sagot

{ "order": 84213 }

action=status

Status ng order

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “status”
order	int	hindi	Order ID
orders	int[]	hindi	Comma-separated IDs, up to 100

Sagot

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

Sagot para sa batch

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

Humiling ng refill

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “refill”
order	int	hindi	Order ID
orders	int[]	hindi	Comma-separated IDs, up to 100

Sagot

{ "refill": 1932 }

Sagot para sa batch

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “refill_status”
refill	int	hindi	Refill ID
refills	int[]	hindi	Comma-separated IDs, up to 100

Sagot

{ "status": "Completed" }

Sagot para sa batch

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

action=cancel

Kanselahin ang order

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

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “cancel”
order	int	hindi	Order ID
orders	int[]	hindi	Comma-separated IDs, up to 100

Sagot

{ "cancel": 1 }

Sagot para sa batch

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

action=balance

Balanse

Current account balance, in rubles.

Parameter	Uri	Kinakailangan	Paglalarawan
key	string	oo	API key from your dashboard, “API” tab
action	string	oo	The string “balance”

Sagot

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

Mga halimbawa ng code

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

Mga status ng order

Nagbabalik ang status field ng status method ng isa sa mga value na ito.

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

Mga error

Bumabalik ang mga business error na may HTTP 200 at error field. Tanging authentication at rate limiting lang ang gumagamit ng HTTP status code.

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

Handa nang magkonekta?

Gumawa ng account, mag-top up ng balanse at bumuo ng key sa API tab. Walang hiwalay na approval step.

Gumawa ng account