உருவாக்குநர்களுக்கு

மறுவிற்பனையாளர்கள் மற்றும் தானியங்குதலுக்கான API

Q: முறைகள்

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

ஒரே HTTP முகவரி முழு சுழற்சியையும் மூடுகிறது: பட்டியலைப் பெறு, ஆர்டரை உருவாக்கு, நிலையை அறிய, Refill அல்லது ரத்து கோரு. நெறிமுறை பெரும்பாலான SMM பேனல்கள் பயன்படுத்தும் வடிவத்துடன் பொருந்துகிறது, எனவே தயார் ஒருங்கிணைப்பிற்கு பொதுவாக முகவரி மற்றும் சாவியை மாற்றுவது போதுமானது.

முகவரி

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

POST மட்டும். உடலை application/x-www-form-urlencoded அல்லது application/json ஆக அனுப்பலாம் — இரண்டு வடிவங்களும் ஏற்கப்படுகின்றன, பதில் எப்போதும் JSON.

அங்கீகாரம்

சாவி வினவல் உடலில் key புலம் மூலம் அனுப்பப்படுகிறது. எங்களிடம் அதன் SHA-256 ஹாஷ் மட்டுமே சேமிக்கப்படுகிறது, எனவே தரவுத்தளத்திலிருந்து சாவியை மீட்க முடியாது — இழந்தால், புதியதை உருவாக்கவும். சாவியை டாஷ்போர்டில் எப்போது வேண்டுமானாலும் முடக்கலாம், அது உடனே வேலை செய்வதை நிறுத்தும்.

அதிர்வெண் கட்டுப்பாடு

ஒரு IP முகவரியிலிருந்து நிமிடத்திற்கு 60 வினவல்கள். மீறினால் 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

இணைக்க தயாராக உள்ளீர்களா?

கணக்கை உருவாக்கு