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

Forriturum

API fyrir endursöluaðila og sjálfvirkni

Einn HTTP endapunktur nær öllum ferli: lesa efnisskrá, stofna pantanir, fylgjast með stöðu, biðja um refill eða hætta við. Samskiptamátinn samsvarar því sem flestir SMM spjöld nota, þannig að fyrirliggjandi samþættingu nægir yfirleitt að breyta vistfangi og lykli.

Vistfang

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

Aðeins POST. Sendu annaðhvort sem application/x-www-form-urlencoded eða application/json — bæði eru samþykkt og svör eru alltaf JSON.

Auðkenning

Lykillinn er sendur í beiðni sem key reitur. Við geymum aðeins SHA-256 hasha hans, svo ekki er hægt að endurheimta lykilinn úr gagnagrunni — ef hann týnist, gefðu út nýjan. Lykli má afturkalla á mælaborði hvenær sem er og hann hættir að virka samstundis.

Hraðatakmörk

60 beiðnir á mínútu frá einu IP vistfangi. Yfir það svarar endapunkturinn 429 og inniheldur Retry-After haus sem segir hversu margar sekúndur á að bíða. Spyrðu um stöður í hópum gegnum orders fremur en eina beiðni per pöntun.

Aðferðir

action=services

Þjónustulisti

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “services”

Svar

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

action=add

Stofna pöntun

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “add”
service	int	já	Service ID from the services method
link	string	já	Link to the profile or post. The format is validated per platform and metric
quantity	int	já	Quantity within the service min and max
runs	int	nei	Drip-feed: how many runs
interval	int	nei	Drip-feed: interval between runs, in minutes

Svar

{ "order": 84213 }

action=status

Staða pöntunar

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “status”
order	int	nei	Pöntunarnúmer
orders	int[]	nei	Comma-separated IDs, up to 100

Svar

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

Svar fyrir hóp

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

Biðja um refill

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “refill”
order	int	nei	Pöntunarnúmer
orders	int[]	nei	Comma-separated IDs, up to 100

Svar

{ "refill": 1932 }

Svar fyrir hóp

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “refill_status”
refill	int	nei	Refill ID
refills	int[]	nei	Comma-separated IDs, up to 100

Svar

{ "status": "Completed" }

Svar fyrir hóp

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

action=cancel

Hætta við pöntun

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “cancel”
order	int	nei	Pöntunarnúmer
orders	int[]	nei	Comma-separated IDs, up to 100

Svar

{ "cancel": 1 }

Svar fyrir hóp

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

action=balance

Innistæða

Current account balance, in rubles.

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “balance”

Svar

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

Kóðadæmi

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

Stöður pantana

Status reiturinn í status aðferðinni skilar einni af þessum gildum.

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

Villur

Rekstrarvillur koma með HTTP 200 og error reit. Aðeins auðkenning og hraðatakmörk nota HTTP stöðukóða.

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

Tilbúinn að tengjast?

Stofnaðu aðgang, fylltu upp innistæðu og gefðu út lykil á „API“ flipanum. Engin sérstök samþykki er nauðsynleg.

Stofna aðgang

Forriturum

API fyrir endursöluaðila og sjálfvirkni

Vistfang

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

Aðeins POST. Sendu annaðhvort sem application/x-www-form-urlencoded eða application/json — bæði eru samþykkt og svör eru alltaf JSON.

Auðkenning

Hraðatakmörk

Aðferðir

action=services

Þjónustulisti

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “services”

Svar

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

action=add

Stofna pöntun

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “add”
service	int	já	Service ID from the services method
link	string	já	Link to the profile or post. The format is validated per platform and metric
quantity	int	já	Quantity within the service min and max
runs	int	nei	Drip-feed: how many runs
interval	int	nei	Drip-feed: interval between runs, in minutes

Svar

{ "order": 84213 }

action=status

Staða pöntunar

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “status”
order	int	nei	Pöntunarnúmer
orders	int[]	nei	Comma-separated IDs, up to 100

Svar

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

Svar fyrir hóp

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

Biðja um refill

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “refill”
order	int	nei	Pöntunarnúmer
orders	int[]	nei	Comma-separated IDs, up to 100

Svar

{ "refill": 1932 }

Svar fyrir hóp

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “refill_status”
refill	int	nei	Refill ID
refills	int[]	nei	Comma-separated IDs, up to 100

Svar

{ "status": "Completed" }

Svar fyrir hóp

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

action=cancel

Hætta við pöntun

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

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “cancel”
order	int	nei	Pöntunarnúmer
orders	int[]	nei	Comma-separated IDs, up to 100

Svar

{ "cancel": 1 }

Svar fyrir hóp

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

action=balance

Innistæða

Current account balance, in rubles.

Breyta	Tegund	Skylda	Lýsing
key	string	já	API key from your dashboard, “API” tab
action	string	já	The string “balance”

Svar

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

Kóðadæmi

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

Stöður pantana

Status reiturinn í status aðferðinni skilar einni af þessum gildum.

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

Villur

Rekstrarvillur koma með HTTP 200 og error reit. Aðeins auðkenning og hraðatakmörk nota HTTP stöðukóða.

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

Tilbúinn að tengjast?

Stofnaðu aðgang, fylltu upp innistæðu og gefðu út lykil á „API“ flipanum. Engin sérstök samþykki er nauðsynleg.

Stofna aðgang