დეველოპერებისთვის

API რესელერებისა და ავტომატიზაციისთვის

Q: მეთოდები

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

ერთი HTTP-მისამართი ხურავს მთელ ციკლს: მიიღეთ კატალოგი, შექმენით შეკვეთა, გაიგეთ სტატუსი, მოითხოვეთ აღდგენა ან გაუქმება. პროტოკოლი ემთხვევა ფორმატს, რომელსაც უმეტესობა 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

შევსების მოთხოვნა

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

შევსების მოთხოვნა

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

მზად ხართ დაკავშირებისთვის?

ანგარიშის შექმნა