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 ሃሽ ብቻ ነው የሚቀመጠው፣ ስለዚህ ቁልፉን ከባዝ መመለስ አይቻልም — ካጣዎ አዲስ ይፍጠሩ። ቁልፍን በዳሽቦርድ በማንኛውም ጊዜ ማጥፋት ይቻላል፣ ወዲያውኑ ከስራ ይቆማል።

የድግግሞሽ ገደብ

ከአንድ 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

POST ብቻ። አካሉን application/x-www-form-urlencoded ወይም application/json ልከው ይላኩ — ሁለቱም ቅርጸቶች ይቀበላሉ፣ ምላሹ ሁሌም JSON ነው።

ማረጋገጫ

የድግግሞሽ ገደብ

ዘዴዎች

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» ትብ ላይ ቁልፍ ይፍጠሩ። የተወሰነ ስምማት አይጠይቅም።

መለያ ይፍጠሩ