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

Kūrėjams

API perpardavėjams ir automatizacijai

Vienas HTTP adresas apima visą ciklą: gauti katalogą, sukurti užsakymą, sužinoti būseną, prašyti Refill ar atšaukimo. Protokolas atitinka formatą, kurį naudoja dauguma SMM skydelių, todėl esamai integracijai paprastai pakanka pakeisti adresą ir raktą.

Adresas

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

Tik POST. Tekstą galima siųsti kaip application/x-www-form-urlencoded arba application/json – abu formatai priimami, atsakymas visada JSON.

Autentifikacija

Raktas siunčiamas užklausos tekste key lauku. Mes saugome tik jo SHA-256 hash'ą, todėl rakto iš duomenų bazės atkurti negalima – jei jis prarastas, sukurk naują. Raktą galima atšaukti skydelyje bet kuriuo metu, jis iškart nustoja veikti.

Užklausų limitas

60 užklausų per minutę iš vieno IP adreso. Viršijus gaunamas 429 kodas ir Retry-After antraštė su sekundžių skaičiumi iki kitos bandymo. Būsenas geriau užklausti paketomis per orders, o ne po vieną užsakymą per kreipinį.

Metodai

action=services

Paslaugų sąrašas

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “services”

Atsakymas

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

action=add

Sukurti užsakymą

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “add”
service	int	taip	Service ID from the services method
link	string	taip	Link to the profile or post. The format is validated per platform and metric
quantity	int	taip	Quantity within the service min and max
runs	int	ne	Drip-feed: how many runs
interval	int	ne	Drip-feed: interval between runs, in minutes

Atsakymas

{ "order": 84213 }

action=status

Užsakymo būsena

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “status”
order	int	ne	Užsakymo ID
orders	int[]	ne	Comma-separated IDs, up to 100

Atsakymas

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

Paketo atsakymas

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

Prašyti Refill

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “refill”
order	int	ne	Užsakymo ID
orders	int[]	ne	Comma-separated IDs, up to 100

Atsakymas

{ "refill": 1932 }

Paketo atsakymas

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “refill_status”
refill	int	ne	Refill ID
refills	int[]	ne	Comma-separated IDs, up to 100

Atsakymas

{ "status": "Completed" }

Paketo atsakymas

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

action=cancel

Atšaukti užsakymą

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “cancel”
order	int	ne	Užsakymo ID
orders	int[]	ne	Comma-separated IDs, up to 100

Atsakymas

{ "cancel": 1 }

Paketo atsakymas

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

action=balance

Balansas

Current account balance, in rubles.

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “balance”

Atsakymas

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

Kodo pavyzdžiai

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

Užsakymo būsenos

status metodo laukas status grąžina vieną iš šių reikšmių.

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

Klaidos

Verslo logikos klaidos grįžta su HTTP 200 ir error lauku. Tik autentifikacija ir užklausų limitavimas naudoja HTTP būsenos 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

Pasirengę prisijungti?

Sukurk paskyrą, papildyk balansą ir išrašyk raktą API skirtuke. Atskiro patvirtinimo nereikia.

Sukurti paskyrą

Kūrėjams

API perpardavėjams ir automatizacijai

Adresas

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

Tik POST. Tekstą galima siųsti kaip application/x-www-form-urlencoded arba application/json – abu formatai priimami, atsakymas visada JSON.

Autentifikacija

Užklausų limitas

Metodai

action=services

Paslaugų sąrašas

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “services”

Atsakymas

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

action=add

Sukurti užsakymą

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “add”
service	int	taip	Service ID from the services method
link	string	taip	Link to the profile or post. The format is validated per platform and metric
quantity	int	taip	Quantity within the service min and max
runs	int	ne	Drip-feed: how many runs
interval	int	ne	Drip-feed: interval between runs, in minutes

Atsakymas

{ "order": 84213 }

action=status

Užsakymo būsena

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “status”
order	int	ne	Užsakymo ID
orders	int[]	ne	Comma-separated IDs, up to 100

Atsakymas

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

Paketo atsakymas

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

Prašyti Refill

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “refill”
order	int	ne	Užsakymo ID
orders	int[]	ne	Comma-separated IDs, up to 100

Atsakymas

{ "refill": 1932 }

Paketo atsakymas

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “refill_status”
refill	int	ne	Refill ID
refills	int[]	ne	Comma-separated IDs, up to 100

Atsakymas

{ "status": "Completed" }

Paketo atsakymas

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

action=cancel

Atšaukti užsakymą

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

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “cancel”
order	int	ne	Užsakymo ID
orders	int[]	ne	Comma-separated IDs, up to 100

Atsakymas

{ "cancel": 1 }

Paketo atsakymas

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

action=balance

Balansas

Current account balance, in rubles.

Parametras	Tipas	Privalomas	Aprašymas
key	string	taip	API key from your dashboard, “API” tab
action	string	taip	The string “balance”

Atsakymas

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

Kodo pavyzdžiai

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

Užsakymo būsenos

status metodo laukas status grąžina vieną iš šių reikšmių.

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

Klaidos

Verslo logikos klaidos grįžta su HTTP 200 ir error lauku. Tik autentifikacija ir užklausų limitavimas naudoja HTTP būsenos 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

Pasirengę prisijungti?

Sukurk paskyrą, papildyk balansą ir išrašyk raktą API skirtuke. Atskiro patvirtinimo nereikia.

Sukurti paskyrą