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

Pour les développeurs

API pour revendeurs et automatisation

Une seule adresse HTTP couvre tout le cycle : récupérer le catalogue, créer une commande, consulter son statut, demander un refill ou une annulation. Le protocole reprend le format utilisé par la plupart des panneaux SMM : une intégration existante n’a généralement qu’à changer d’adresse et de clé.

Adresse

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

POST uniquement. Le corps peut être envoyé en application/x-www-form-urlencoded ou en application/json : les deux sont acceptés, la réponse est toujours en JSON.

Authentification

La clé est transmise dans le corps de la requête via le champ key. Nous n’en conservons que l’empreinte SHA-256 : elle ne peut donc pas être retrouvée dans notre base. En cas de perte, générez-en une nouvelle. Une clé peut être désactivée à tout moment depuis votre compte et cesse aussitôt de fonctionner.

Limite de fréquence

60 requêtes par minute depuis une même adresse IP. Au-delà, le serveur renvoie un code 429 et un en-tête Retry-After indiquant le délai d’attente en secondes. Interrogez les statuts par lots via orders plutôt qu’une commande à la fois.

Méthodes

action=services

Liste des services

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “services”

Réponse

[
  {
    "service": 21251,
    "name": "Telegram — просмотры",
    "type": "Default",
    "category": "Telegram",
    "rate": 0.41,
    "min": 10,
    "max": 50000000,
    "refill": true,
    "cancel": true
  }
]

action=add

Créer une commande

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “add”
service	int	oui	Service ID from the services method
link	string	oui	Link to the profile or post. The format is validated per platform and metric
quantity	int	oui	Quantity within the service min and max
runs	int	non	Drip-feed: how many runs
interval	int	non	Drip-feed: interval between runs, in minutes

Réponse

{ "order": 84213 }

action=status

Statut de la commande

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “status”
order	int	non	Numéro de commande
orders	int[]	non	Comma-separated IDs, up to 100

Réponse

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

Réponse groupée

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

Demander un refill

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “refill”
order	int	non	Numéro de commande
orders	int[]	non	Comma-separated IDs, up to 100

Réponse

{ "refill": 1932 }

Réponse groupée

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “refill_status”
refill	int	non	Refill ID
refills	int[]	non	Comma-separated IDs, up to 100

Réponse

{ "status": "Completed" }

Réponse groupée

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

action=cancel

Annuler la commande

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “cancel”
order	int	non	Numéro de commande
orders	int[]	non	Comma-separated IDs, up to 100

Réponse

{ "cancel": 1 }

Réponse groupée

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

action=balance

Solde

Current account balance, in rubles.

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “balance”

Réponse

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

Exemples de code

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

Statuts de commande

Le champ status de la méthode status renvoie l’une de ces valeurs.

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

Erreurs

Les erreurs métier arrivent avec un code 200 et un champ error. Seules l’authentification et la limite de fréquence répondent par des codes 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

Prêt à vous connecter ?

Inscrivez-vous, rechargez votre solde et générez une clé dans l’onglet « API ». Aucune validation préalable n’est nécessaire.

Créer un compte

Pour les développeurs

API pour revendeurs et automatisation

Adresse

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

POST uniquement. Le corps peut être envoyé en application/x-www-form-urlencoded ou en application/json : les deux sont acceptés, la réponse est toujours en JSON.

Authentification

Limite de fréquence

Méthodes

action=services

Liste des services

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “services”

Réponse

[
  {
    "service": 21251,
    "name": "Telegram — просмотры",
    "type": "Default",
    "category": "Telegram",
    "rate": 0.41,
    "min": 10,
    "max": 50000000,
    "refill": true,
    "cancel": true
  }
]

action=add

Créer une commande

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “add”
service	int	oui	Service ID from the services method
link	string	oui	Link to the profile or post. The format is validated per platform and metric
quantity	int	oui	Quantity within the service min and max
runs	int	non	Drip-feed: how many runs
interval	int	non	Drip-feed: interval between runs, in minutes

Réponse

{ "order": 84213 }

action=status

Statut de la commande

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “status”
order	int	non	Numéro de commande
orders	int[]	non	Comma-separated IDs, up to 100

Réponse

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

Réponse groupée

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

Demander un refill

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “refill”
order	int	non	Numéro de commande
orders	int[]	non	Comma-separated IDs, up to 100

Réponse

{ "refill": 1932 }

Réponse groupée

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “refill_status”
refill	int	non	Refill ID
refills	int[]	non	Comma-separated IDs, up to 100

Réponse

{ "status": "Completed" }

Réponse groupée

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

action=cancel

Annuler la commande

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

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “cancel”
order	int	non	Numéro de commande
orders	int[]	non	Comma-separated IDs, up to 100

Réponse

{ "cancel": 1 }

Réponse groupée

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

action=balance

Solde

Current account balance, in rubles.

Paramètre	Type	Obligatoire	Description
key	string	oui	API key from your dashboard, “API” tab
action	string	oui	The string “balance”

Réponse

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

Exemples de code

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

Statuts de commande

Le champ status de la méthode status renvoie l’une de ces valeurs.

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

Erreurs

Les erreurs métier arrivent avec un code 200 et un champ error. Seules l’authentification et la limite de fréquence répondent par des codes 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

Prêt à vous connecter ?

Inscrivez-vous, rechargez votre solde et générez une clé dans l’onglet « API ». Aucune validation préalable n’est nécessaire.

Créer un compte