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

Մշակողներին

API վերավաճառողների և ավտոմատացման համար

Մեկ HTTP հասցեն փակում է ամբողջ ցիկլը՝ ստանալ կատալոգը, ստեղծել պատվերը, իմանալ կարգավիճակը, խնդրել Refill կամ չեղարկում։ Պրոտոկոլը համընկնում է այն ձևաչափի հետ, որն օգտագործում են մեծամասնություն SMM վահանակները, ուստի առկա ինտեգրմանը սովորաբար բավարար է փոխել հասցեն և բանալին։

Հասցե

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

Միայն POST։ Մարմինը կարելի է ուղարկել որպես application/x-www-form-urlencoded կամ application/json — ընդունվում են երկու ձևաչափերն էլ, պատասխանը միշտ JSON։

Վավերացում

Բանալին փոխանցվում է հարցման մարմնում key դաշտով։ Մեզ մոտ պահվում է միայն դրա SHA-256 հեշը, ուստի բանալին բազայից վերականգնել հնարավոր չէ — եթե այն կորցրել եք, թողարկեք նորը։ Բանալին կարելի է անջատել վահանակում ցանկացած պահի, այն անմիջապես դադարում է աշխատել։

Հաճախականության սահմանափակում

60 հարցում րոպեում մեկ IP հասցեից։ Գերազանցման դեպքում գալիս է 429 կոդ և Retry-After վերնագիրը՝ հաջորդ փորձից առաջ մնացած վայրկյանների քանակով։ Կարգավիճակներն ավելի լավ է հարցնել խմբով՝ orders-ի միջոցով, ոչ թե մեկ պատվերի համար կանչից։

Մեթոդներ

action=services

Ծառայությունների ցանկ

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “services”

Պատասխան

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

action=add

Ստեղծել պատվեր

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “add”
service	int	այո	Service ID from the services method
link	string	այո	Link to the profile or post. The format is validated per platform and metric
quantity	int	այո	Quantity within the service min and max
runs	int	ոչ	Drip-feed: how many runs
interval	int	ոչ	Drip-feed: interval between runs, in minutes

Պատասխան

{ "order": 84213 }

action=status

Պատվերի կարգավիճակ

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “status”
order	int	ոչ	Պատվերի համարը
orders	int[]	ոչ	Comma-separated IDs, up to 100

Պատասխան

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

Պատասխան փաթեթի համար

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

Խնդրել Refill

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “refill”
order	int	ոչ	Պատվերի համարը
orders	int[]	ոչ	Comma-separated IDs, up to 100

Պատասխան

{ "refill": 1932 }

Պատասխան փաթեթի համար

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “refill_status”
refill	int	ոչ	Refill ID
refills	int[]	ոչ	Comma-separated IDs, up to 100

Պատասխան

{ "status": "Completed" }

Պատասխան փաթեթի համար

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

action=cancel

Չեղարկել պատվերը

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “cancel”
order	int	ոչ	Պատվերի համարը
orders	int[]	ոչ	Comma-separated IDs, up to 100

Պատասխան

{ "cancel": 1 }

Պատասխան փաթեթի համար

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

action=balance

Բալանս

Current account balance, in rubles.

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “balance”

Պատասխան

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

Կոդի օրինակներ

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

Պատվերի կարգավիճակներ

status մեթոդի status դաշտը վերադարձնում է այս արժեքներից մեկը։

pending: Accepted by the panel, not yet sent to the provider
in_progress: Կատարվում է
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

Սխալներ

Բիզնես տրամաբանության սխալները գալիս են 200 կոդով և error դաշտով։ 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

Պատրա՞ստ եք միանալ։

Գրանցվեք, լիցքավորեք բալանսը և թողարկեք բանալին «API» ներդիրում։ Առանձին համաձայնեցում պետք չէ։

Ստեղծել հաշիվ

Մշակողներին

API վերավաճառողների և ավտոմատացման համար

Հասցե

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

Վավերացում

Հաճախականության սահմանափակում

Մեթոդներ

action=services

Ծառայությունների ցանկ

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “services”

Պատասխան

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

action=add

Ստեղծել պատվեր

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “add”
service	int	այո	Service ID from the services method
link	string	այո	Link to the profile or post. The format is validated per platform and metric
quantity	int	այո	Quantity within the service min and max
runs	int	ոչ	Drip-feed: how many runs
interval	int	ոչ	Drip-feed: interval between runs, in minutes

Պատասխան

{ "order": 84213 }

action=status

Պատվերի կարգավիճակ

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “status”
order	int	ոչ	Պատվերի համարը
orders	int[]	ոչ	Comma-separated IDs, up to 100

Պատասխան

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

Պատասխան փաթեթի համար

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

Խնդրել Refill

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “refill”
order	int	ոչ	Պատվերի համարը
orders	int[]	ոչ	Comma-separated IDs, up to 100

Պատասխան

{ "refill": 1932 }

Պատասխան փաթեթի համար

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “refill_status”
refill	int	ոչ	Refill ID
refills	int[]	ոչ	Comma-separated IDs, up to 100

Պատասխան

{ "status": "Completed" }

Պատասխան փաթեթի համար

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

action=cancel

Չեղարկել պատվերը

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

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “cancel”
order	int	ոչ	Պատվերի համարը
orders	int[]	ոչ	Comma-separated IDs, up to 100

Պատասխան

{ "cancel": 1 }

Պատասխան փաթեթի համար

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

action=balance

Բալանս

Current account balance, in rubles.

Պարամետր	Տիպ	Պարտադիր է	Նկարագրություն
key	string	այո	API key from your dashboard, “API” tab
action	string	այո	The string “balance”

Պատասխան

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

Կոդի օրինակներ

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

Պատվերի կարգավիճակներ

status մեթոդի status դաշտը վերադարձնում է այս արժեքներից մեկը։

pending: Accepted by the panel, not yet sent to the provider
in_progress: Կատարվում է
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

Սխալներ

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

Պատրա՞ստ եք միանալ։

Գրանցվեք, լիցքավորեք բալանսը և թողարկեք բանալին «API» ներդիրում։ Առանձին համաձայնեցում պետք չէ։

Ստեղծել հաշիվ