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

Udviklere

API til forhandlere og automatisering

Ét HTTP-endpoint dækker hele arbejdsgangen: læs kataloget, opret ordrer, forespørg status, anmod om Refill eller annullering. Protokollen matcher det format, de fleste SMM-paneller bruger, så en eksisterende integration skal som regel kun have ny URL og nøgle.

Adresse

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

Kun POST. Send enten application/x-www-form-urlencoded eller application/json — begge accepteres, og svaret er altid JSON.

Godkendelse

Nøglen sendes i anmodningskroppen som feltet key. Vi gemmer kun dens SHA-256-hash, så en nøgle kan ikke gendannes fra databasen — hvis du mister den, skal du oprette en ny. En nøgle kan tilbagekaldes fra dashboardet når som helst og holder straks op med at virke.

Hastighedsgrænse

60 anmodninger i minuttet fra én IP-adresse. Overskrides det, svarer endpointet med 429 og en Retry-After-header, der fortæller, hvor mange sekunder du skal vente. Hent statusser i batches via orders frem for én anmodning pr. ordre.

Metoder

action=services

Tjenesteliste

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	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

Opret ordre

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “add”
service	int	ja	Service ID from the services method
link	string	ja	Link to the profile or post. The format is validated per platform and metric
quantity	int	ja	Quantity within the service min and max
runs	int	nej	Drip-feed: how many runs
interval	int	nej	Drip-feed: interval between runs, in minutes

Svar

{ "order": 84213 }

action=status

Ordre-status

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “status”
order	int	nej	Ordre-ID
orders	int[]	nej	Comma-separated IDs, up to 100

Svar

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

Batch-svar

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

Anmod om Refill

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill”
order	int	nej	Ordre-ID
orders	int[]	nej	Comma-separated IDs, up to 100

Svar

{ "refill": 1932 }

Batch-svar

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill_status”
refill	int	nej	Refill ID
refills	int[]	nej	Comma-separated IDs, up to 100

Svar

{ "status": "Completed" }

Batch-svar

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

action=cancel

Annuller ordre

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “cancel”
order	int	nej	Ordre-ID
orders	int[]	nej	Comma-separated IDs, up to 100

Svar

{ "cancel": 1 }

Batch-svar

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

action=balance

Saldo

Current account balance, in rubles.

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “balance”

Svar

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

Kodeeksempler

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

Ordre-statusser

Feltet status i metoden status returnerer en af disse værdier.

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

Fejl

Erhvervsmæssige fejl returneres med HTTP 200 og et error-felt. Kun godkendelse og hastighedsgrænser bruger HTTP-statuskoder.

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

Klar til at forbinde?

Opret en konto, indsæt på saldoen, og opret en nøgle under fanen »API«. Der er ingen separat godkendelsesproces.

Opret konto

Udviklere

API til forhandlere og automatisering

Adresse

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

Kun POST. Send enten application/x-www-form-urlencoded eller application/json — begge accepteres, og svaret er altid JSON.

Godkendelse

Hastighedsgrænse

Metoder

action=services

Tjenesteliste

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	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

Opret ordre

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “add”
service	int	ja	Service ID from the services method
link	string	ja	Link to the profile or post. The format is validated per platform and metric
quantity	int	ja	Quantity within the service min and max
runs	int	nej	Drip-feed: how many runs
interval	int	nej	Drip-feed: interval between runs, in minutes

Svar

{ "order": 84213 }

action=status

Ordre-status

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “status”
order	int	nej	Ordre-ID
orders	int[]	nej	Comma-separated IDs, up to 100

Svar

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

Batch-svar

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

Anmod om Refill

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill”
order	int	nej	Ordre-ID
orders	int[]	nej	Comma-separated IDs, up to 100

Svar

{ "refill": 1932 }

Batch-svar

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “refill_status”
refill	int	nej	Refill ID
refills	int[]	nej	Comma-separated IDs, up to 100

Svar

{ "status": "Completed" }

Batch-svar

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

action=cancel

Annuller ordre

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

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “cancel”
order	int	nej	Ordre-ID
orders	int[]	nej	Comma-separated IDs, up to 100

Svar

{ "cancel": 1 }

Batch-svar

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

action=balance

Saldo

Current account balance, in rubles.

Parameter	Type	Påkrævet	Beskrivelse
key	string	ja	API key from your dashboard, “API” tab
action	string	ja	The string “balance”

Svar

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

Kodeeksempler

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

Ordre-statusser

Feltet status i metoden status returnerer en af disse værdier.

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

Fejl

Erhvervsmæssige fejl returneres med HTTP 200 og et error-felt. Kun godkendelse og hastighedsgrænser bruger HTTP-statuskoder.

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

Klar til at forbinde?

Opret en konto, indsæt på saldoen, og opret en nøgle under fanen »API«. Der er ingen separat godkendelsesproces.

Opret konto